SettleMint SDK

✨ https://settlemint.com ✨
Integrate SettleMint into your application with ease.

Table of Contents

• About
• Usage
• API Reference
• Contributing
• License

About

The SettleMint CLI provides a command-line interface for interacting with the SettleMint platform. It enables you to manage your blockchain networks, deploy smart contracts, configure your SettleMint infrastructure directly from the terminal.

Usage

Login to the platform

To use the SettleMint CLI, you first need to authenticate with the platform. Create a Personal Access Token (PAT) on the SettleMint platformand paste it when prompted by the login command.

Visit the documentation to learn how to create a Personal Access Token.

Then run the login command and paste your token when prompted:

settlemint login

Creating a new project from a starter kit template

To create a new project from a starter kit template, use the create command with the --template flag:

settlemint create --project-name <project-name> --template <template-name>

Installing dependencies

To install the dependencies for your project, use the dependencies command.

Using bun

bun install
bun run dependencies

Using npm

npm install
npm run dependencies

Using yarn

yarn install
yarn run dependencies

Using pnpm

pnpm install
pnpm run dependencies

Connecting to your SettleMint infrastructure

After creating your project, you'll need to connect it to your SettleMint infrastructure. This requires setting up environment variables with your SettleMint credentials and infrastructure details.

You can use the connect command to automatically configure your project and select the services you want to connect to.

settlemint connect

Deploying your smart contracts and subgraphs

To deploy your smart contracts and subgraphs, you can use the deploy command.

settlemint scs hardhat deploy remote --accept-defaults

To deploy your subgraphs, use the subgraph command.

settlemint scs subgraph deploy --accept-defaults <subgraph-name>

Generating code for your dApp

After deploying your smart contracts and subgraphs, you can generate TypeScript code for your dApp to interact with them. The codegen command will generate type-safe code for your integrations with the services selected in the connect command.

settlemint codegen

Start your dApp in development mode

bun run dev

Creating a new project from a smart contract template

To create a new project from a smart contract template, use the create command with the --use-case flag:

settlemint scs create --project-name <project-name> --use-case <use-case-name>

Testing your smart contracts on a local network

To test your smart contracts, you can use the test command.

settlemint scs foundry test

Deploying your smart contracts and subgraphs

To deploy your smart contracts and subgraphs, you can use the deploy command.

settlemint scs hardhat deploy remote --accept-defaults

To deploy your subgraphs, use the subgraph command.

settlemint scs subgraph deploy --accept-defaults <subgraph-name>

API Reference

See the documentation for available commands.

Contributing

We welcome contributions from the community! Please check out our Contributing guide to learn how you can help improve the SettleMint SDK through bug reports, feature requests, documentation updates, or code contributions.

License

The SettleMint SDK is released under the FSL Software License. See the LICENSE file for more details.