Skip to content

Commit

Permalink
feat: add basic README
Browse files Browse the repository at this point in the history
  • Loading branch information
legion2002 committed Dec 6, 2024
1 parent 3362f64 commit 971ae80
Show file tree
Hide file tree
Showing 2 changed files with 87 additions and 15 deletions.
87 changes: 87 additions & 0 deletions src/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,87 @@
# Module SDK

**A TypeScript Library for Interacting with the Rhinestone Orchestrator**

> **Important:** The Orchestrator is currently under development. While the SDK and APIs are relatively stable, please anticipate ongoing improvements and potential breaking changes in the coming weeks.
### For Developers

The Orchestrator SDK provides the following capabilities:

- **Create a User Account Cluster:** Add accounts across multiple chains to a single cluster.
- **Fetch Total Portfolio Balance:** Retrieve the overall balance of a user account cluster.
- **Obtain Order Bundles:** Get an order bundle for a specific meta intent associated with a user account.
- **Sign Order Bundles:** Utilize an ownable validator to sign order bundles (please create an issue for support regarding specific validators).
- **Post Signed Order Bundles:** Submit signed order bundles to the orchestrator for processing by relayers.
- **Check Order Bundle Status:** Monitor the status of submitted order bundles.

Additionally, the Orchestrator SDK exposes useful types and ABIs that developers can leverage when interacting with the Orchestrator.

### For Solvers

The Orchestrator SDK enables you to:

- **Retrieve Claim Payloads:** Obtain signed claim payloads from the orchestrator after executing a fill on the target chain.
- **Perform Source Chain Deposits:** Use the claim payloads to facilitate deposits on the source chain.

If you are looking for a mock implementation of a relayer, please visit our [Rhinestone Relayer Repository](https://github.com/rhinestonewtf/rhinestone-relayer).

For comprehensive documentation on the Chain Abstraction System, please refer to: [Chain Abstraction Docs](https://rhinestone.notion.site/Chain-Abstraction-Docs-External-4790f4303e934b16a6fb24637e6f67e7?pvs=4).

For API documentation, visit: [Swagger Docs](https://orchestrator-prototype-38oyp.ondigitalocean.app/api-docs/).

### Note

> You need an API key to interact with most useful Orchestrator functions. If you're interested in building on top of our system, please reach out to the team.
## Using the Orchestrator SDK

### Installation

```bash
npm install viem @rhinestone/orchestrator-sdk
```

```bash
pnpm install viem @rhinestone/orchestrator-sdk
```

```bash
yarn add viem @rhinestone/orchestrator-sdk
```

```bash
bun install viem @rhinestone/orchestrator-sdk
```

### Quick Start

```typescript
Coming soon ...

( Please refer to the tests for now )
```

## Using this repo

To install dependencies, run:

```bash
pnpm install
```

To build the sdk, run:

```bash
pnpm build
```

To run tests, run:

```bash
pnpm test
```

## Contributing

For feature or change requests, feel free to open a PR, start a discussion or get in touch with us.
15 changes: 0 additions & 15 deletions src/package.json
Original file line number Diff line number Diff line change
Expand Up @@ -17,21 +17,6 @@
"import": "./_esm/index.js",
"default": "./_cjs/index.js"
},
"./account": {
"types": "./_types/account/index.d.ts",
"import": "./_esm/account/index.js",
"default": "./_cjs/account/index.js"
},
"./module": {
"types": "./_types/module/index.d.ts",
"import": "./_esm/module/index.js",
"default": "./_cjs/module/index.js"
},
"./common": {
"types": "./_types/common/index.d.ts",
"import": "./_esm/common/index.js",
"default": "./_cjs/common/index.js"
},
"./package.json": "./package.json"
},
"peerDependencies": {
Expand Down

0 comments on commit 971ae80

Please sign in to comment.