How to Create Your First Blockchain Application in 2 Minutes

Answer:

• Organization = Your company/team workspace with billing, members, and permissions
• Application = Individual blockchain project (like a dApp, smart contract suite, or use case)
• Best practice: One organization per company, multiple applications per use case

Why do you need to understand SettleMint's project structure?

Answer: SettleMint's structure enables enterprise-grade blockchain development with proper governance, team collaboration, and cost management from day one. This prevents common issues like unclear billing, security gaps, and deployment chaos.

SettleMint hierarchy explained

When to create multiple organizations

Recommended structure:

• One organization per company/department for billing and governance
• Multiple applications per organization for different use cases
• Example: "Acme Corp" organization with "Supply Chain", "Payments", and "Identity" applications

Click confirm to go to the organization dashboard. From here, you can create your first application in this organization. The dashboard will show you a summary of your organization's applications, the members in this organization, and a status of the resource costs for the current month.

When you create an organization, you are the owner, and therefore an administrator of the organization. This means you can perform all actions within this organization, with no limitations.

Invite new organization members

Navigate to the members section of your organization, via the homepage, or via your organization dashboard.

Follow these steps to invite new members to your organization:

1. Click invite new member.
2. Enter the email adress of the person you want to invite.
3. Select their role, i.e. whether they will be an administrator or a user.
4. Optionally, you can add a message to be included in the invitation email.
5. Click confirm to go to the list of your organization's members. Your email invitation has now been sent, and you see in the list that it is pending.

Manage an organization

Navigate to the organization dashboard.

Click manage organization to see the available actions. You can only perform these actions if you have administrator rights for this organization.

• change name - Changes the organization name without any further impact.
• delete organization - Removes the organization from the platform.

On organization dashboard

• See all applications in that organization.
• See all members of the organization
• See all the internal applications and clients if in partner mode

Create an application

An application is the context in which you organize your networks, nodes, smart contract sets and any other related blockchain resource.

How to create a new application

settlemint login

settlemint platform create application <name>

import { createSettleMintClient } from '@settlemint/sdk-js';

const client = createSettleMintClient({
  accessToken: 'your_access_token',
  instance: 'https://console.settlemint.com'
});

// Create application
const createApp = async () => {
  const result = await client.application.create({
    workspaceUniqueName: "your-workspace",
    name: "myApp"
  });
  console.log('Application created:', result);
};

// List applications
const listApps = async () => {
  const apps = await client.application.list("your-workspace");
  console.log('Applications:', apps);
};

// Read application details
const readApp = async () => {
  const app = await client.application.read("app-unique-name");
  console.log('Application details:', app);
};

// Delete application
const deleteApp = async () => {
  await client.application.delete("application-unique-name");
};

Manage an application

The SettleMint platform dashboard provides a centralized view of blockchain infrastructure, offering real-time insights into system components. With health status indicators, including error and warning counts, it ensures system stability while enabling users to proactively address potential issues. Resource usage tracking helps manage costs efficiently, providing month-to-date expense insights.

Each component features a "details" link for quick access to in-depth information, while the intuitive navigation panel allows seamless access to key modules such as audit logs, access tokens, and insights. Built-in support options further enhance usability, ensuring users can quickly troubleshoot and resolve issues.

# List applications
settlemint platform list applications

# Delete application
settlemint platform delete application <name>

// List applications
await client.application.list("your-workspace");

// Read application
await client.application.read("app-unique-name");

// Delete application
await client.application.delete("app-unique-name");