Examples: Accounts and Delegation

This example demonstrates the core functionality of account management and delegation using the Quicksilver SDK's fluent API. It showcases how to:

1. Create a main agent account: An initial, high-level account that can oversee others.
2. Delegate sub-agent accounts: Establish child accounts (e.g., 'Research Sub-Agent', 'Writing Sub-Agent') under the main agent, inheriting hierarchical relationships and potentially operating within specific limits.
3. Retrieve delegated sub-agents: Access the list of accounts delegated by a parent account using the active Account model's methods.
4. Update account limits: Modify the financial restrictions (e.g., daily spending) for an account.
5. Check account balances: Query the current balance of any account.

All these operations leverage the SDK's Account active model, providing an intuitive and type-safe way to manage your programmable money infrastructure.

examples/1-accounts-and-delegation.ts

Explanation

In this example:

1. A QuicksilverClient is initialized in sandbox mode.
2. A mainAgent account is created using client.accounts.create(). This method directly returns an Account active model instance.
3. Two sub-agent accounts, researchAgent and writingAgent, are created by calling the delegate() method directly on the mainAgent instance. This illustrates how parent accounts can fluently create and manage child accounts.
4. The mainAgent.getChildren() method is used to retrieve all accounts delegated by mainAgent, returning an array of Account instances.
5. mainAgent.updateLimits() demonstrates how to modify an account's financial constraints, such as its daily spending limit.
6. Finally, mainAgent.getBalance() fetches the current balance associated with the account, showcasing real-time financial introspection capabilities.

This comprehensive example highlights the power of the Account active model in simplifying complex account and delegation logic into readable, object-oriented code.

Further Reading

• Getting Started
• API Reference: Account Model