@sequence0/sdk 1.1.2 → 2.0.0

package/dist/core/client.d.ts

@@ -23,9 +23,14 @@
  * ```
  */
 import { NetworkConfig, CreateWalletOptions, HealthResponse, StatusResponse, WalletDetail, SignResultResponse } from './types';
+import { ProgramDeployOptions, ProgramInfo } from './programmable';
+import { AtomicSignOptions, AtomicSignResult } from './atomic';
+import { DelegateOptions, SubDelegateOptions, DelegationGrant, DelegationTree, AuthorityStatus } from './delegation';
 import { Wallet } from '../wallet/wallet';
 import { WsClient } from '../utils/websocket';
 import { UnsignedFeeTx } from '../utils/fee';
+import { SettlementClient } from '../settlement/settlement';
+import { UniversalAccountClient, UniversalAccountInfo, CreateUniversalAccountOptions } from './universal-account';
 export declare class Sequence0 {
     private config;
     private http;
@@ -40,6 +45,10 @@ export declare class Sequence0 {
     private ownerSigner;
     /** Owner's Ethereum address (derived from private key when provided) */
     private ownerAddress;
+    /** Optional delegate signer for K4 delegated signing */
+    private delegateSigner;
+    /** Delegation grant ID for delegated signing */
+    private delegationId;
     /**
      * Create a new Sequence0 SDK client
      *
@@ -218,6 +227,207 @@ export declare class Sequence0 {
      * ```
      */
     buildFeeTx(walletId: string): Promise<UnsignedFeeTx | null>;
+    /**
+     * Deploy a WASM signing policy program to the Sequence0 chain.
+     *
+     * The WASM bytecode is uploaded to the ProgramRegistry contract and
+     * assigned a unique programId (bytes32). Once deployed, the program
+     * can be attached to any wallet owned by the deployer.
+     *
+     * @param options - Program deployment options (bytecode, metadata, limits)
+     * @returns programId as a bytes32 hex string
+     *
+     * @throws {Sequence0Error} If no ownerSigner is configured
+     * @throws {NetworkError} If the deployment transaction fails
+     *
+     * @example
+     * ```typescript
+     * const programId = await s0.deployProgram({
+     *   bytecode: fs.readFileSync('spending-limit.wasm'),
+     *   metadataUri: 'ipfs://Qm.../metadata.json',
+     *   gasLimit: 5_000_000,
+     *   memoryLimit: 16,
+     * });
+     * console.log('Deployed program:', programId);
+     * ```
+     */
+    deployProgram(options: ProgramDeployOptions): Promise<string>;
+    /**
+     * Attach a WASM program to a wallet.
+     *
+     * Only the wallet owner can attach programs. Once attached, the program
+     * runs on every sign request for this wallet -- the agent evaluates it
+     * in a sandboxed WASM environment and rejects the request if the program
+     * returns "deny".
+     *
+     * @param walletId - The wallet to attach the program to
+     * @param programId - The program ID (bytes32 hex) from deployProgram()
+     *
+     * @throws {Sequence0Error} If no ownerSigner is configured
+     * @throws {NetworkError} If the attach transaction fails
+     *
+     * @example
+     * ```typescript
+     * await s0.attachProgram('my-wallet', programId);
+     * ```
+     */
+    attachProgram(walletId: string, programId: string): Promise<void>;
+    /**
+     * Detach a WASM program from a wallet.
+     *
+     * Only the wallet owner can detach programs. The program is no longer
+     * evaluated on sign requests for this wallet after detachment.
+     *
+     * @param walletId - The wallet to detach the program from
+     * @param programId - The program ID (bytes32 hex) to detach
+     *
+     * @throws {Sequence0Error} If no ownerSigner is configured
+     * @throws {NetworkError} If the detach transaction fails
+     *
+     * @example
+     * ```typescript
+     * await s0.detachProgram('my-wallet', programId);
+     * ```
+     */
+    detachProgram(walletId: string, programId: string): Promise<void>;
+    /**
+     * Get all WASM programs attached to a wallet.
+     *
+     * @param walletId - The wallet to query
+     * @returns Array of program info objects
+     *
+     * @throws {NetworkError} If the agent is unreachable
+     *
+     * @example
+     * ```typescript
+     * const programs = await s0.getWalletPrograms('my-wallet');
+     * for (const p of programs) {
+     *   console.log(`${p.programId}: active=${p.isActive}, gas=${p.gasLimit}`);
+     * }
+     * ```
+     */
+    getWalletPrograms(walletId: string): Promise<ProgramInfo[]>;
+    /**
+     * Sign multiple transactions across chains atomically (all-or-nothing).
+     *
+     * Submits a batch of signing operations to the agent network. The agents
+     * coordinate via a 2-phase commit protocol: either all operations produce
+     * valid signatures, or the entire batch is aborted and no signatures are
+     * released.
+     *
+     * This is essential for:
+     *   - Cross-chain arbitrage (buy on chain A, sell on chain B)
+     *   - Bridge transfers (lock on source, mint on destination)
+     *   - Multi-leg DeFi strategies
+     *
+     * @param options - Atomic signing options with operations array
+     * @returns Result with all signatures (if committed) or error (if aborted)
+     *
+     * @throws {Sequence0Error} If no ownerSigner is configured or operations are empty
+     * @throws {TimeoutError} If the atomic signing times out
+     *
+     * @example
+     * ```typescript
+     * const result = await s0.signAtomic({
+     *   operations: [
+     *     { walletId: 'eth-wallet', chain: 'ethereum', message: '0x...' },
+     *     { walletId: 'arb-wallet', chain: 'arbitrum', message: '0x...' },
+     *   ],
+     *   timeout: 60000,
+     * });
+     *
+     * if (result.status === 'committed') {
+     *   for (const [reqId, sig] of result.signatures) {
+     *     console.log(`${reqId}: ${sig}`);
+     *   }
+     * } else {
+     *   console.error('Atomic signing aborted:', result.error);
+     * }
+     * ```
+     */
+    signAtomic(options: AtomicSignOptions): Promise<AtomicSignResult>;
+    /**
+     * Get a SettlementClient for K3 Universal Settlement Network operations.
+     *
+     * The settlement client provides methods to submit payment intents,
+     * query cycle status, and retrieve settlement history. Intents are
+     * batched and netted off-chain, then settled atomically via K2.
+     *
+     * @returns A SettlementClient instance bound to the current agent
+     *
+     * @example
+     * ```typescript
+     * const settlement = s0.getSettlementClient();
+     *
+     * const { intentHash, cycleId } = await settlement.submitIntent(
+     *   {
+     *     senderWalletId: 'alice-wallet',
+     *     recipientWalletId: 'bob-wallet',
+     *     chain: 'ethereum',
+     *     amount: '1000000000000000000',
+     *   },
+     *   ownerSignature,
+     *   timestamp,
+     * );
+     *
+     * const cycle = await settlement.getCurrentCycle();
+     * console.log(`Cycle ${cycle.cycleId}: ${cycle.status}`);
+     * ```
+     */
+    getSettlementClient(): Promise<SettlementClient>;
+    /**
+     * Get a UniversalAccountClient bound to a healthy agent.
+     *
+     * The client communicates directly with the agent's `/universal/*`
+     * endpoints for account creation, balance queries, and sends.
+     *
+     * @returns A UniversalAccountClient instance
+     *
+     * @example
+     * ```typescript
+     * const ua = await s0.getUniversalAccountClient();
+     *
+     * const balance = await ua.getUnifiedBalance('ua-abc123');
+     * console.log('Chains:', balance.totalChains);
+     *
+     * const route = await ua.previewRoute({
+     *   accountId: 'ua-abc123',
+     *   to: '0x...',
+     *   amount: '1.0',
+     *   token: 'ETH',
+     * });
+     * console.log(`Route: ${route.sourceChain} -> ${route.destinationChain}`);
+     * ```
+     */
+    getUniversalAccountClient(): Promise<UniversalAccountClient>;
+    /**
+     * Create a new universal account — one identity across all 81 chains.
+     *
+     * This is a convenience method that discovers a healthy agent,
+     * creates a UniversalAccountClient, and calls createAccount.
+     * For repeated operations, prefer `getUniversalAccountClient()`
+     * and reuse the client.
+     *
+     * @param options - Account creation options
+     * @returns The created account info with all chain addresses
+     *
+     * @example
+     * ```typescript
+     * const account = await s0.createUniversalAccount({
+     *   ownerSignature: '0x...',
+     *   timestamp: Date.now(),
+     * });
+     *
+     * console.log('Account ID:', account.accountId);
+     * console.log('Ethereum:', account.chainAddresses.ethereum.address);
+     * console.log('Bitcoin:', account.chainAddresses.bitcoin.address);
+     * console.log('Solana:', account.chainAddresses.solana.address);
+     * ```
+     *
+     * @throws {Sequence0Error} If the creation parameters are invalid
+     * @throws {NetworkError} If no healthy agent is available
+     */
+    createUniversalAccount(options: CreateUniversalAccountOptions): Promise<UniversalAccountInfo>;
     /**
      * Subscribe to real-time events from the agent network
      *
@@ -259,5 +469,33 @@ export declare class Sequence0 {
      */
     private warnIfHttp;
     private generateWalletId;
+    /**
+     * Create a delegation grant for a wallet (owner only).
+     */
+    createDelegation(walletId: string, options: DelegateOptions): Promise<DelegationGrant>;
+    /**
+     * Create a sub-delegation from an existing delegation grant.
+     */
+    createSubDelegation(walletId: string, options: SubDelegateOptions): Promise<DelegationGrant>;
+    /**
+     * Revoke a delegation grant (cascading to all sub-grants).
+     */
+    revokeDelegation(walletId: string, delegationId: string): Promise<void>;
+    /**
+     * List all delegation grants for a wallet.
+     */
+    listDelegations(walletId: string): Promise<DelegationGrant[]>;
+    /**
+     * Get the delegation tree for a wallet.
+     */
+    getDelegationTree(walletId: string): Promise<DelegationTree>;
+    /**
+     * Send heartbeat for dead-man's switch delegation grants.
+     */
+    heartbeat(walletId: string): Promise<void>;
+    /**
+     * Check remaining authority status of a delegation.
+     */
+    checkAuthority(delegationId: string): Promise<AuthorityStatus>;
 }
 //# sourceMappingURL=client.d.ts.map

package/dist/core/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/core/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EACH,aAAa,EACb,mBAAmB,EAEnB,cAAc,EACd,cAAc,EAEd,YAAY,EAGZ,kBAAkB,EAErB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,MAAM,EAAgB,MAAM,kBAAkB,CAAC;AAExD,OAAO,EAAE,QAAQ,EAAa,MAAM,oBAAoB,CAAC;AAEzD,OAAO,EAAc,aAAa,EAAE,MAAM,cAAc,CAAC;AAsIzD,qBAAa,SAAS;IAClB,OAAO,CAAC,MAAM,CAA2D;IACzE,OAAO,CAAC,IAAI,CAA2B;IACvC,OAAO,CAAC,EAAE,CAAyB;IACnC,OAAO,CAAC,SAAS,CAA+B;IAChD,OAAO,CAAC,UAAU,CAA2B;IAC7C,OAAO,CAAC,gBAAgB,CAAuB;IAC/C,OAAO,CAAC,cAAc,CAAwC;IAC9D,4EAA4E;IAC5E,OAAO,CAAC,YAAY,CAAkC;IACtD,kDAAkD;IAClD,OAAO,CAAC,WAAW,CAA4B;IAC/C,wEAAwE;IACxE,OAAO,CAAC,YAAY,CAAuB;IAE3C;;;;;;;;;;;;;;;;;;;;;;OAsBG;gBACS,MAAM,EAAE,aAAa;IAyEjC;;;OAGG;YACW,OAAO;IAYrB;;;OAGG;YACW,WAAW;IAwBzB;;;;OAIG;YACW,mBAAmB;IA0BjC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAS5B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAYxB;;;;OAIG;YACW,YAAY;IAoC1B;;;;;;;;;;;;OAYG;IACG,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC;IA8GjE;;;;;;;;;;OAUG;IACG,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA0BlD;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAY5C;;;;;;OAMG;IACG,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAyB1E;;;;;OAKG;IACG,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAYxE;;;;;;;OAOG;IACG,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC;IA8CzF;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,cAAc,CAAC;IAO1C;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,cAAc,CAAC;IAOvC;;;OAGG;IACG,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBlD;;OAEG;IACG,cAAc;IAIpB;;;OAGG;IACG,iBAAiB;IAQvB;;;;;;;;;;;;;;;;OAgBG;IACG,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC;IAKxC;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACG,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAkCjE;;;;;;;;;OASG;IACG,SAAS,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAWrD;;;OAGG;IACH,OAAO,IAAI,IAAI;YAyBD,WAAW;IAUzB,OAAO,CAAC,SAAS;IAMjB,OAAO,CAAC,gBAAgB;IAexB;;;;;;;;;OASG;YACW,kBAAkB;IAuBhC;;;;OAIG;IACH,OAAO,CAAC,oBAAoB;IAkC5B;;OAEG;IACH,OAAO,CAAC,UAAU;IAWlB,OAAO,CAAC,gBAAgB;CAK3B"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/core/client.ts"],"names":[],"mappings":"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"}