@settlemint/sdk-cli 0.8.6-pr9429cc29 → 0.8.6-pr97bfb525

package/README.md

@@ -7,7 +7,7 @@
     Integrate SettleMint into your application with ease.
   </p>
 </p>
-<br/>
+
 <p align="center">
 <a href="https://github.com/settlemint/sdk/actions?query=branch%3Amain"><img src="https://github.com/settlemint/sdk/actions/workflows/build.yml/badge.svg?event=push&branch=main" alt="CI status" /></a>
 <a href="https://fsl.software" rel="nofollow"><img src="https://img.shields.io/npm/l/@settlemint/sdk-cli" alt="License"></a>
@@ -26,45 +26,158 @@
   <br />
 </div>
 
-## Getting started
+## Table of Contents
+
+- [About](#about)
+- [Usage](#usage)
+  - [Login to the platform](#login-to-the-platform)
+  - [Creating a new project from a starter kit template](#creating-a-new-project-from-a-starter-kit-template)
+    - [Installing dependencies](#installing-dependencies)
+    - [Connecting to your SettleMint infrastructure](#connecting-to-your-settlemint-infrastructure)
+    - [Deploying your smart contracts and subgraphs](#deploying-your-smart-contracts-and-subgraphs)
+    - [Generating code for your dApp](#generating-code-for-your-dapp)
+    - [Start your dApp in development mode](#start-your-dapp-in-development-mode)
+  - [Creating a new project from a smart contract template](#creating-a-new-project-from-a-smart-contract-template)
+    - [Testing your smart contracts on a local network](#testing-your-smart-contracts-on-a-local-network)
+    - [Deploying your smart contracts and subgraphs](#deploying-your-smart-contracts-and-subgraphs)
+- [API Reference](#api-reference)
+- [Contributing](#contributing)
+- [License](#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](https://console.settlemint.com/documentation/docs/using-platform/personal-access-tokens/) to learn how to create a Personal Access Token.
+
+Then run the login command and paste your token when prompted:
+
+```bash
+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:
+
+```bash
+settlemint create --project-name <project-name> --template <template-name>
+```
+
+#### Installing dependencies
+
+To install the dependencies for your project, use the `dependencies` command.
+
+##### Using bun
+
+```bash
+bun install
+bun run dependencies
+```
+
+##### Using npm
+
+```bash
+npm install
+npm run dependencies
+```
+
+##### Using yarn
+
+```bash
+yarn install
+yarn run dependencies
+```
+
+##### Using pnpm
+
+```bash
+pnpm install
+pnpm run dependencies
+```
+
+#### Connecting to your SettleMint infrastructure
 
-First we will create a new Next JS project using the following command.
+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.
 
 ```bash
-# Using npx
-npx @settlemint/sdk-cli@latest create
+settlemint connect
+```
 
-# Using bun
-bunx @settlemint/sdk-cli@latest create
+#### Deploying your smart contracts and subgraphs
 
-# Using pnpm
-pnpm dlx @settlemint/sdk-cli@latest create
+To deploy your smart contracts and subgraphs, you can use the `deploy` command.
+
+```bash
+settlemint scs hardhat deploy remote --accept-defaults
 ```
 
-Then following the next steps in your terminal.
+To deploy your subgraphs, use the `subgraph` command.
 
+```bash
+settlemint scs subgraph deploy --accept-defaults <subgraph-name>
+```
 
-## Local development
+#### Generating code for your dApp
 
-### Debugging
+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.
 
-To debug with interactive input you need to start the command from the terminal and then attach the debugger.
+```bash
+settlemint codegen
+```
+
+#### Start your dApp in development mode
 
 ```bash
-bun --inspect-wait=localhost:6499/ sdk/cli/src/cli.ts create
-# Attach the debugger using the "SDK: Attach to process" configuration
+bun run dev
+```
 
-# Run from the directory created by the create command
-bun --inspect-wait=localhost:6499/ sdk/cli/src/cli.ts connect
-# Attach the debugger using the "SDK: Attach to process" configuration
+### 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:
+
+```bash
+settlemint scs create --project-name <project-name> --use-case <use-case-name>
 ```
 
-### e2e tests
+#### Testing your smart contracts on a local network
+
+To test your smart contracts, you can use the `test` command.
+
+```bash
+settlemint scs foundry test
+```
+
+#### Deploying your smart contracts and subgraphs
+
+To deploy your smart contracts and subgraphs, you can use the `deploy` command.
+
+```bash
+settlemint scs hardhat deploy remote --accept-defaults
+```
+
+To deploy your subgraphs, use the `subgraph` command.
+
+```bash
+settlemint scs subgraph deploy --accept-defaults <subgraph-name>
+```
+
+## API Reference
+
+See the [documentation](./docs/settlemint.md) for available commands.
+
+## Contributing
+
+We welcome contributions from the community! Please check out our [Contributing](../../.github/CONTRIBUTING.md) guide to learn how you can help improve the SettleMint SDK through bug reports, feature requests, documentation updates, or code contributions.
 
-Create a ".env" file in the root folder of this project.
+## License
 
-```env
-SETTLEMINT_ACCESS_TOKEN_E2E_TESTS="sm_pat_xxx"
-SETTLEMINT_INSTANCE="https://me.settlemint.be"
-DISABLE_WORKSPACE_DELETE=true
-```
+The SettleMint SDK is released under the [FSL Software License](https://fsl.software). See the [LICENSE](LICENSE) file for more details.