Getting Started with Quicksilver SDK

The Quicksilver SDK provides a powerful, fluent Domain-Specific Language (DSL) for programmable money, allowing developers to build sophisticated economic interactions with elegant, type-safe code. This guide will walk you through the essential steps to get started.

📦 Installation

To begin, install the Quicksilver SDK in your project using npm or Bun:

🎯 Quick Start

1. Initialize the Client

First, you need to initialize the QuicksilverClient with your API key. For testing purposes, you can use the sandbox environment.

2. Create Active Accounts

Quicksilver allows you to create active Account models with built-in methods. You can create main agents and fluently delegate sub-agents.

3. Define Conditional Logic

The SDK provides a fluent DSL for defining complex conditional logic, replacing cumbersome JSON blobs with readable, type-safe code using the client.condition() builder.

Note: QuickSilverEvent and Action should be imported from quicksilver-sdk.

4. Create Programmable Products

Define your services and multi-agent workflows as programmable products using the client.product() builder. This allows you to encapsulate pricing, guarantees, and stages into reusable definitions.

5. Execute Transactions

With accounts, conditions, and products defined, you can now create and execute transactions using the fluent interface directly from an Account instance. You can also trigger events on transactions to activate conditional logic.

You are now ready to explore the full capabilities of the Quicksilver SDK to build intelligent economic interactions! Refer to the Examples section for more detailed use cases.