@sequence0/sdk 1.2.0 → 2.0.0

package/dist/settlement/settlement.d.ts

@@ -0,0 +1,152 @@
+/**
+ * K3: Universal Settlement Network -- multilateral netting + atomic settlement
+ *
+ * Provides a settlement layer for batching and netting payment intents across
+ * multiple wallets and chains. Instead of executing every individual transfer
+ * on-chain, the settlement engine accumulates intents during a cycle, computes
+ * net positions via multilateral netting, and settles only the net amounts
+ * atomically using K2 cross-chain signing.
+ *
+ * Settlement cycles:
+ *   1. OPEN    -- intents are accepted and queued
+ *   2. NETTING -- cycle closes, net positions are computed (off-chain)
+ *   3. SETTLING -- atomic signing + broadcast of net transfers (via K2)
+ *   4. COMPLETE -- all net transfers confirmed on-chain
+ *   5. FAILED  -- one or more net transfers could not settle
+ *
+ * @example
+ * ```typescript
+ * import { Sequence0 } from '@sequence0/sdk';
+ *
+ * const s0 = new Sequence0({ network: 'mainnet', ownerPrivateKey: '0x...' });
+ * const settlement = s0.getSettlementClient();
+ *
+ * // Submit a payment intent
+ * const { intentHash, cycleId } = await settlement.submitIntent(
+ *   {
+ *     senderWalletId: 'alice-eth-wallet',
+ *     recipientWalletId: 'bob-eth-wallet',
+ *     chain: 'ethereum',
+ *     amount: '1000000000000000000', // 1 ETH
+ *   },
+ *   ownerSignature,
+ *   timestamp,
+ * );
+ *
+ * // Check current cycle status
+ * const cycle = await settlement.getCurrentCycle();
+ * console.log(cycle.status); // 'open' | 'netting' | 'settling' | 'complete'
+ * ```
+ */
+import { Chain } from '../core/types';
+import { HttpClient } from '../utils/http';
+export interface SettlementIntent {
+    /** Wallet ID of the sender */
+    senderWalletId: string;
+    /** Wallet ID of the recipient */
+    recipientWalletId: string;
+    /** Target blockchain for settlement */
+    chain: Chain;
+    /** Amount in the chain's smallest denomination (e.g. wei, lamports) */
+    amount: string;
+    /** Token contract address. Omit for native token transfers. */
+    token?: string;
+}
+export interface SettlementCycle {
+    /** Unique cycle identifier */
+    cycleId: number;
+    /** Current cycle status */
+    status: 'open' | 'netting' | 'settling' | 'complete' | 'failed';
+    /** Number of intents in this cycle */
+    intentCount: number;
+    /** Unix timestamp when the cycle opened */
+    openedAt: number;
+    /** Unix timestamp when the cycle closed (undefined if still open) */
+    closedAt?: number;
+}
+export interface NetPosition {
+    /** Sender wallet ID (after netting) */
+    senderWallet: string;
+    /** Recipient wallet ID (after netting) */
+    recipientWallet: string;
+    /** Chain for this net transfer */
+    chain: string;
+    /** Net amount to transfer (smallest denomination) */
+    netAmount: string;
+}
+export interface SettlementResult {
+    /** Cycle that was settled */
+    cycleId: number;
+    /** K2 atomic manifest ID used for settlement */
+    manifestId: string;
+    /** Final status */
+    status: 'complete' | 'failed';
+    /** Computed net positions that were settled */
+    netPositions: NetPosition[];
+    /** Error message if settlement failed */
+    error?: string;
+}
+/**
+ * Settlement client for K3 Universal Settlement Network.
+ *
+ * Communicates with settlement endpoints on the agent node to submit
+ * payment intents, query cycle status, and retrieve settlement history.
+ */
+export declare class SettlementClient {
+    private httpClient;
+    /**
+     * Create a new SettlementClient
+     *
+     * @param baseUrl - Agent node REST API URL
+     * @param httpClient - Shared HttpClient instance for making requests
+     */
+    constructor(baseUrl: string, httpClient: HttpClient);
+    /**
+     * Submit a payment intent to the current open settlement cycle.
+     *
+     * The intent is queued for netting when the cycle closes. The caller must
+     * provide an ownership proof (signature + timestamp) to authorize the
+     * sender wallet.
+     *
+     * @param intent - Payment intent details
+     * @param ownerSignature - EIP-712 ownership proof signature (hex string)
+     * @param timestamp - Unix timestamp used in the ownership proof
+     * @returns The intent hash and the cycle it was assigned to
+     *
+     * @throws {Sequence0Error} If the intent is invalid or the cycle is not open
+     * @throws {NetworkError} If the agent is unreachable
+     */
+    submitIntent(intent: SettlementIntent, ownerSignature: string, timestamp: number): Promise<{
+        intentHash: string;
+        cycleId: number;
+    }>;
+    /**
+     * Get the current open settlement cycle.
+     *
+     * @returns Current cycle status
+     * @throws {NetworkError} If the agent is unreachable
+     */
+    getCurrentCycle(): Promise<SettlementCycle>;
+    /**
+     * Get a specific settlement cycle by ID.
+     *
+     * @param cycleId - The cycle ID to look up
+     * @returns Cycle status and details
+     * @throws {Sequence0Error} If the cycle is not found
+     * @throws {NetworkError} If the agent is unreachable
+     */
+    getCycle(cycleId: number): Promise<SettlementCycle>;
+    /**
+     * Get settlement cycle history.
+     *
+     * @param limit - Max number of cycles to return (default: 20)
+     * @returns Array of settlement cycles, most recent first
+     * @throws {NetworkError} If the agent is unreachable
+     */
+    getCycleHistory(limit?: number): Promise<SettlementCycle[]>;
+    /**
+     * Map a raw cycle response from the agent to the SettlementCycle interface.
+     */
+    private mapCycleResponse;
+}
+//# sourceMappingURL=settlement.d.ts.map

package/dist/settlement/settlement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settlement.d.ts","sourceRoot":"","sources":["../../src/settlement/settlement.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAK3C,MAAM,WAAW,gBAAgB;IAC7B,8BAA8B;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,iCAAiC;IACjC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,uCAAuC;IACvC,KAAK,EAAE,KAAK,CAAC;IACb,uEAAuE;IACvE,MAAM,EAAE,MAAM,CAAC;IACf,+DAA+D;IAC/D,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAID,MAAM,WAAW,eAAe;IAC5B,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,2BAA2B;IAC3B,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,QAAQ,CAAC;IAChE,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAID,MAAM,WAAW,WAAW;IACxB,uCAAuC;IACvC,YAAY,EAAE,MAAM,CAAC;IACrB,0CAA0C;IAC1C,eAAe,EAAE,MAAM,CAAC;IACxB,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,SAAS,EAAE,MAAM,CAAC;CACrB;AAID,MAAM,WAAW,gBAAgB;IAC7B,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB;IACnB,MAAM,EAAE,UAAU,GAAG,QAAQ,CAAC;IAC9B,+CAA+C;IAC/C,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAID;;;;;GAKG;AACH,qBAAa,gBAAgB;IACzB,OAAO,CAAC,UAAU,CAAa;IAE/B;;;;;OAKG;gBACS,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU;IAInD;;;;;;;;;;;;;;OAcG;IACG,YAAY,CACd,MAAM,EAAE,gBAAgB,EACxB,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,GAClB,OAAO,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IA0CnD;;;;;OAKG;IACG,eAAe,IAAI,OAAO,CAAC,eAAe,CAAC;IAYjD;;;;;;;OAOG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAgBzD;;;;;;OAMG;IACG,eAAe,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAuBjE;;OAEG;IACH,OAAO,CAAC,gBAAgB;CA0B3B"}

package/dist/settlement/settlement.js

@@ -0,0 +1,172 @@
+"use strict";
+/**
+ * K3: Universal Settlement Network -- multilateral netting + atomic settlement
+ *
+ * Provides a settlement layer for batching and netting payment intents across
+ * multiple wallets and chains. Instead of executing every individual transfer
+ * on-chain, the settlement engine accumulates intents during a cycle, computes
+ * net positions via multilateral netting, and settles only the net amounts
+ * atomically using K2 cross-chain signing.
+ *
+ * Settlement cycles:
+ *   1. OPEN    -- intents are accepted and queued
+ *   2. NETTING -- cycle closes, net positions are computed (off-chain)
+ *   3. SETTLING -- atomic signing + broadcast of net transfers (via K2)
+ *   4. COMPLETE -- all net transfers confirmed on-chain
+ *   5. FAILED  -- one or more net transfers could not settle
+ *
+ * @example
+ * ```typescript
+ * import { Sequence0 } from '@sequence0/sdk';
+ *
+ * const s0 = new Sequence0({ network: 'mainnet', ownerPrivateKey: '0x...' });
+ * const settlement = s0.getSettlementClient();
+ *
+ * // Submit a payment intent
+ * const { intentHash, cycleId } = await settlement.submitIntent(
+ *   {
+ *     senderWalletId: 'alice-eth-wallet',
+ *     recipientWalletId: 'bob-eth-wallet',
+ *     chain: 'ethereum',
+ *     amount: '1000000000000000000', // 1 ETH
+ *   },
+ *   ownerSignature,
+ *   timestamp,
+ * );
+ *
+ * // Check current cycle status
+ * const cycle = await settlement.getCurrentCycle();
+ * console.log(cycle.status); // 'open' | 'netting' | 'settling' | 'complete'
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SettlementClient = void 0;
+const errors_1 = require("../utils/errors");
+// ── Settlement Client ──
+/**
+ * Settlement client for K3 Universal Settlement Network.
+ *
+ * Communicates with settlement endpoints on the agent node to submit
+ * payment intents, query cycle status, and retrieve settlement history.
+ */
+class SettlementClient {
+    /**
+     * Create a new SettlementClient
+     *
+     * @param baseUrl - Agent node REST API URL
+     * @param httpClient - Shared HttpClient instance for making requests
+     */
+    constructor(baseUrl, httpClient) {
+        this.httpClient = httpClient;
+    }
+    /**
+     * Submit a payment intent to the current open settlement cycle.
+     *
+     * The intent is queued for netting when the cycle closes. The caller must
+     * provide an ownership proof (signature + timestamp) to authorize the
+     * sender wallet.
+     *
+     * @param intent - Payment intent details
+     * @param ownerSignature - EIP-712 ownership proof signature (hex string)
+     * @param timestamp - Unix timestamp used in the ownership proof
+     * @returns The intent hash and the cycle it was assigned to
+     *
+     * @throws {Sequence0Error} If the intent is invalid or the cycle is not open
+     * @throws {NetworkError} If the agent is unreachable
+     */
+    async submitIntent(intent, ownerSignature, timestamp) {
+        if (!intent.senderWalletId || typeof intent.senderWalletId !== 'string') {
+            throw new errors_1.Sequence0Error('senderWalletId must be a non-empty string');
+        }
+        if (!intent.recipientWalletId || typeof intent.recipientWalletId !== 'string') {
+            throw new errors_1.Sequence0Error('recipientWalletId must be a non-empty string');
+        }
+        if (!intent.amount || typeof intent.amount !== 'string') {
+            throw new errors_1.Sequence0Error('amount must be a non-empty string');
+        }
+        if (!ownerSignature || typeof ownerSignature !== 'string') {
+            throw new errors_1.Sequence0Error('ownerSignature must be a non-empty string');
+        }
+        if (typeof timestamp !== 'number' || timestamp <= 0) {
+            throw new errors_1.Sequence0Error('timestamp must be a positive number');
+        }
+        const response = await this.httpClient.post('/settlement/submit-intent', {
+            sender_wallet_id: intent.senderWalletId,
+            recipient_wallet_id: intent.recipientWalletId,
+            chain: intent.chain,
+            amount: intent.amount,
+            token: intent.token,
+            owner_signature: ownerSignature,
+            timestamp,
+        });
+        if (!response || typeof response.intent_hash !== 'string') {
+            throw new errors_1.Sequence0Error('Invalid response from /settlement/submit-intent: missing intent_hash');
+        }
+        return {
+            intentHash: response.intent_hash,
+            cycleId: response.cycle_id,
+        };
+    }
+    /**
+     * Get the current open settlement cycle.
+     *
+     * @returns Current cycle status
+     * @throws {NetworkError} If the agent is unreachable
+     */
+    async getCurrentCycle() {
+        const response = await this.httpClient.get('/settlement/cycle/current');
+        return this.mapCycleResponse(response);
+    }
+    /**
+     * Get a specific settlement cycle by ID.
+     *
+     * @param cycleId - The cycle ID to look up
+     * @returns Cycle status and details
+     * @throws {Sequence0Error} If the cycle is not found
+     * @throws {NetworkError} If the agent is unreachable
+     */
+    async getCycle(cycleId) {
+        if (typeof cycleId !== 'number' || cycleId < 0) {
+            throw new errors_1.Sequence0Error('cycleId must be a non-negative number');
+        }
+        const response = await this.httpClient.get(`/settlement/cycle/${cycleId}`);
+        return this.mapCycleResponse(response);
+    }
+    /**
+     * Get settlement cycle history.
+     *
+     * @param limit - Max number of cycles to return (default: 20)
+     * @returns Array of settlement cycles, most recent first
+     * @throws {NetworkError} If the agent is unreachable
+     */
+    async getCycleHistory(limit) {
+        const queryLimit = limit && limit > 0 ? limit : 20;
+        const response = await this.httpClient.get(`/settlement/history?limit=${queryLimit}`);
+        if (!response || !Array.isArray(response.cycles)) {
+            throw new errors_1.Sequence0Error('Invalid response from /settlement/history: missing cycles array');
+        }
+        return response.cycles.map((c) => this.mapCycleResponse(c));
+    }
+    // ── Internals ──
+    /**
+     * Map a raw cycle response from the agent to the SettlementCycle interface.
+     */
+    mapCycleResponse(response) {
+        if (!response || typeof response.cycle_id !== 'number') {
+            throw new errors_1.Sequence0Error('Invalid settlement cycle response: missing cycle_id');
+        }
+        const validStatuses = ['open', 'netting', 'settling', 'complete', 'failed'];
+        const status = validStatuses.includes(response.status)
+            ? response.status
+            : 'open';
+        return {
+            cycleId: response.cycle_id,
+            status,
+            intentCount: response.intent_count ?? 0,
+            openedAt: response.opened_at ?? 0,
+            closedAt: response.closed_at,
+        };
+    }
+}
+exports.SettlementClient = SettlementClient;
+//# sourceMappingURL=settlement.js.map

package/dist/settlement/settlement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settlement.js","sourceRoot":"","sources":["../../src/settlement/settlement.ts"],"names":[],"mappings":"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"}

package/dist/utils/eip712.js

@@ -29,8 +29,8 @@ function abiEncode(slots) {
 }
 /** WalletFactory contract addresses (EIP-712 verifyingContract) */
 exports.WALLET_FACTORY_ADDRESSES = {
-    testnet: '0x2379786fa3fb6e9de621df5ae91ec6035f9122ed',
-    mainnet: '0x06f3556ffa89ca7060c727fff0f7e2444380cb58',
+    testnet: '0x0fdb2d2147b80fd2e9ad4b8d1a70b68c1353afe3',
+    mainnet: '0x05b4df6ab0684bcc82a4a92677e4b46007638604',
 };
 /** Sequence0 chain IDs (EIP-712 chainId) */
 exports.SEQUENCE0_CHAIN_IDS = {

package/dist/utils/fee.d.ts

@@ -12,8 +12,8 @@
  * ```typescript
  * const fee = new FeeManager({
  *     rpcUrl: 'https://rpc.sequence0.network',
- *     feeCollectorAddress: '0x1977f852aa0d16a59c4ea71b6cc72db02803395f',
- *     registryAddress: '0x774d9a0dc937bfdc7636cbc6e0fc37f9a0809177',
+ *     feeCollectorAddress: '0xccd70007534c33b0ab3997d81207fea5e59ca54a',
+ *     registryAddress: '0xdefa5ab7ea6a87ac51628f4cde55bb4d49e62f50',
  * });
  *
  * // Get the current per-signature fee

package/dist/utils/fee.js

@@ -13,8 +13,8 @@
  * ```typescript
  * const fee = new FeeManager({
  *     rpcUrl: 'https://rpc.sequence0.network',
- *     feeCollectorAddress: '0x1977f852aa0d16a59c4ea71b6cc72db02803395f',
- *     registryAddress: '0x774d9a0dc937bfdc7636cbc6e0fc37f9a0809177',
+ *     feeCollectorAddress: '0xccd70007534c33b0ab3997d81207fea5e59ca54a',
+ *     registryAddress: '0xdefa5ab7ea6a87ac51628f4cde55bb4d49e62f50',
  * });
  *
  * // Get the current per-signature fee

package/dist/wallet/wallet.d.ts

@@ -23,6 +23,8 @@
  * ```
  */
 import { Chain, Threshold, SignedTransaction, EvmTransaction, BtcTransaction, SolTransaction, OwnerSigner } from '../core/types';
+import { AtomicOperation, AtomicSignResult } from '../core/atomic';
+import { DelegateOptions, SubDelegateOptions, DelegationGrant, DelegationTree } from '../core/delegation';
 export interface WalletConfig {
     walletId: string;
     chain: Chain;
@@ -134,6 +136,32 @@ export declare class Wallet {
         primaryType?: string;
         message: Record<string, unknown>;
     }): Promise<string>;
+    /**
+     * Sign this wallet's transaction as part of an atomic multi-chain operation.
+     *
+     * Builds the signing message from the provided transaction, combines it
+     * with the other operations, and submits the entire batch atomically via
+     * the agent network. Either all operations succeed or none do.
+     *
+     * @param transaction - Transaction to build and sign for this wallet
+     * @param otherOperations - Other wallet operations in the atomic batch
+     * @returns Atomic result with all signatures or abort error
+     *
+     * @throws {Sequence0Error} If no ownerSigner is configured
+     * @throws {TimeoutError} If the atomic signing times out
+     *
+     * @example
+     * ```typescript
+     * const ethWallet = await s0.getWallet('eth-wallet');
+     * const result = await ethWallet.signInAtomic(
+     *   { to: '0x...', value: '1000000000000000000' },
+     *   [
+     *     { walletId: 'arb-wallet', chain: 'arbitrum', message: '0x...' },
+     *   ],
+     * );
+     * ```
+     */
+    signInAtomic(transaction: EvmTransaction | BtcTransaction | SolTransaction, otherOperations: AtomicOperation[]): Promise<AtomicSignResult>;
     /**
      * Get the wallet's native token balance
      *
@@ -173,5 +201,29 @@ export declare class Wallet {
      * higher level via the BitcoinTaprootAdapter's direct API.
      */
     private extractBitcoinSighash;
+    /**
+     * Delegate signing authority to another address.
+     */
+    delegate(options: DelegateOptions): Promise<DelegationGrant>;
+    /**
+     * Create a sub-delegation from an existing delegation grant.
+     */
+    delegateFrom(options: SubDelegateOptions): Promise<DelegationGrant>;
+    /**
+     * Revoke a delegation grant (cascading to all sub-grants).
+     */
+    revoke(delegationId: string): Promise<void>;
+    /**
+     * List all delegation grants for this wallet.
+     */
+    listDelegations(): Promise<DelegationGrant[]>;
+    /**
+     * Get the delegation tree for this wallet.
+     */
+    getDelegationTree(): Promise<DelegationTree>;
+    /**
+     * Send heartbeat for dead-man's switch delegation grants.
+     */
+    heartbeat(): Promise<void>;
 }
 //# sourceMappingURL=wallet.d.ts.map

package/dist/wallet/wallet.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wallet.d.ts","sourceRoot":"","sources":["../../src/wallet/wallet.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EACH,KAAK,EACL,SAAS,EACT,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,cAAc,EAId,WAAW,EACd,MAAM,eAAe,CAAC;AA+BvB,MAAM,WAAW,YAAY;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,KAAK,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,SAAS,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,mEAAmE;IACnE,WAAW,CAAC,EAAE,WAAW,CAAC;CAC7B;AAED,qBAAa,MAAM;IACf,sDAAsD;IACtD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,wBAAwB;IACxB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,uDAAuD;IACvD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,uCAAuC;IACvC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,0BAA0B;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,WAAW,CAAqB;gBAE5B,MAAM,EAAE,YAAY;IAkBhC;;;;;;;;;;;;;;;OAeG;IACG,IAAI,CAAC,WAAW,EAAE,cAAc,GAAG,cAAc,GAAG,cAAc,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAsCrG;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACG,eAAe,CAAC,WAAW,EAAE,cAAc,GAAG,cAAc,GAAG,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IAKrG;;;;OAIG;IACG,SAAS,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;IAU7D;;;;;;;;OAQG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAwBnD;;;;;;;;;;;OAWG;IACG,aAAa,CAAC,SAAS,EAAE;QAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAChC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC,CAAC;QAC7D,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,GAAG,OAAO,CAAC,MAAM,CAAC;IAwBnB;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAInC;;OAEG;IACH,IAAI,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAe/B;;OAEG;YACW,uBAAuB;IAsErC;;;;;;;;;OASG;YACW,kBAAkB;IAqBhC,OAAO,CAAC,aAAa;IAgDrB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAYhC;IAEF,OAAO,CAAC,UAAU;IAIlB;;;;;;;;;OASG;IACH,OAAO,CAAC,qBAAqB;CAYhC"}
+{"version":3,"file":"wallet.d.ts","sourceRoot":"","sources":["../../src/wallet/wallet.ts"],"names":[],"mappings":"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"}

package/dist/wallet/wallet.js

@@ -215,6 +215,115 @@ class Wallet {
         return this.requestAndWaitSignature(messageHex);
     }
     // ────────────────────────────────────────────────
+    //  Atomic Signing (K2)
+    // ────────────────────────────────────────────────
+    /**
+     * Sign this wallet's transaction as part of an atomic multi-chain operation.
+     *
+     * Builds the signing message from the provided transaction, combines it
+     * with the other operations, and submits the entire batch atomically via
+     * the agent network. Either all operations succeed or none do.
+     *
+     * @param transaction - Transaction to build and sign for this wallet
+     * @param otherOperations - Other wallet operations in the atomic batch
+     * @returns Atomic result with all signatures or abort error
+     *
+     * @throws {Sequence0Error} If no ownerSigner is configured
+     * @throws {TimeoutError} If the atomic signing times out
+     *
+     * @example
+     * ```typescript
+     * const ethWallet = await s0.getWallet('eth-wallet');
+     * const result = await ethWallet.signInAtomic(
+     *   { to: '0x...', value: '1000000000000000000' },
+     *   [
+     *     { walletId: 'arb-wallet', chain: 'arbitrum', message: '0x...' },
+     *   ],
+     * );
+     * ```
+     */
+    async signInAtomic(transaction, otherOperations) {
+        // Build the unsigned transaction to get the signing message
+        const unsignedTx = await this.adapter.buildTransaction(transaction, this.address);
+        let signingMessage;
+        if (this.adapter.getSigningPayload) {
+            signingMessage = this.adapter.getSigningPayload(unsignedTx);
+        }
+        else if (this.chain === 'bitcoin') {
+            signingMessage = this.extractBitcoinSighash(unsignedTx);
+        }
+        else {
+            signingMessage = unsignedTx;
+        }
+        // Build the ownership proof for this wallet
+        const proof = await this.signOwnershipProof('atomic-sign');
+        if (!proof) {
+            throw new errors_1.Sequence0Error('ownerSigner or ownerPrivateKey is required for atomic signing');
+        }
+        // Build proofs for other operations
+        const otherProofs = [];
+        for (const op of otherOperations) {
+            const otherProof = await this.signOwnershipProof('atomic-sign');
+            otherProofs.push(otherProof || { owner_signature: '', timestamp: 0 });
+        }
+        // Combine this wallet's operation with the others
+        const thisOperation = {
+            wallet_id: this.walletId,
+            chain: this.chain,
+            message: signingMessage,
+            owner_signature: proof.owner_signature,
+            timestamp: proof.timestamp,
+        };
+        const allOperations = [
+            thisOperation,
+            ...otherOperations.map((op, i) => ({
+                wallet_id: op.walletId,
+                chain: op.chain,
+                message: op.message,
+                owner_signature: otherProofs[i].owner_signature,
+                timestamp: otherProofs[i].timestamp,
+            })),
+        ];
+        // Submit the atomic signing request
+        const rawResponse = await this.http.post('/sign-atomic', {
+            operations: allOperations,
+            deadline_blocks: 50,
+        });
+        if (!rawResponse || typeof rawResponse.manifest_id !== 'string') {
+            throw new errors_1.Sequence0Error('Invalid response from /sign-atomic: missing manifest_id');
+        }
+        const manifestId = rawResponse.manifest_id;
+        const timeout = 60000;
+        const deadline = Date.now() + timeout;
+        // Poll for completion
+        while (Date.now() < deadline) {
+            const result = await this.http.get(`/sign-atomic/${manifestId}`);
+            if (result.status === 'committed') {
+                const signatures = new Map();
+                if (result.signatures) {
+                    for (const [reqId, sig] of Object.entries(result.signatures)) {
+                        signatures.set(reqId, sig);
+                    }
+                }
+                return {
+                    manifestId,
+                    status: 'committed',
+                    signatures,
+                };
+            }
+            if (result.status === 'aborted') {
+                return {
+                    manifestId,
+                    status: 'aborted',
+                    signatures: new Map(),
+                    error: result.error || 'Atomic signing batch aborted by the agent network',
+                };
+            }
+            await new Promise((r) => setTimeout(r, 1000));
+        }
+        throw new errors_1.TimeoutError(`Atomic signing manifest ${manifestId} timed out after ${timeout}ms`);
+    }
+    // ────────────────────────────────────────────────
     //  Balance & Info
     // ────────────────────────────────────────────────
     /**
@@ -389,6 +498,101 @@ class Wallet {
         }
         return unsignedTxHex;
     }
+    // ────────────────────────────────────────────────
+    //  K4: Sovereign Agency Protocol — Delegation
+    // ────────────────────────────────────────────────
+    /**
+     * Delegate signing authority to another address.
+     */
+    async delegate(options) {
+        const proof = await this.signOwnershipProof('delegate');
+        if (!proof) {
+            throw new errors_1.Sequence0Error('ownerSigner is required to create delegation grants');
+        }
+        return this.http.post('/delegations', {
+            wallet_id: this.walletId,
+            delegate: options.to,
+            chains: options.chains,
+            wasm_policy_id: options.wasmPolicyId,
+            constraints: options.constraints,
+            valid_from: options.validFrom || new Date().toISOString(),
+            valid_until: options.validUntil,
+            sub_delegation: options.subDelegation ?? false,
+            max_sub_depth: options.maxSubDepth ?? 0,
+            activation: options.activation,
+            owner_signature: proof.owner_signature,
+            timestamp: proof.timestamp,
+        });
+    }
+    /**
+     * Create a sub-delegation from an existing delegation grant.
+     */
+    async delegateFrom(options) {
+        const signerKey = options.signerKey.startsWith('0x') ? options.signerKey : '0x' + options.signerKey;
+        const { SigningKey: EthersSigningKey } = require('ethers');
+        const delegateSigningKey = new EthersSigningKey(signerKey);
+        const timestamp = Math.floor(Date.now() / 1000);
+        const chainId = eip712_1.SEQUENCE0_CHAIN_IDS[this.network] || eip712_1.SEQUENCE0_CHAIN_IDS.mainnet;
+        const walletFactory = eip712_1.WALLET_FACTORY_ADDRESSES[this.network] || eip712_1.WALLET_FACTORY_ADDRESSES.mainnet;
+        const digest = (0, eip712_1.computeEip712Digest)(this.walletId, 'sub-delegate', timestamp, chainId, walletFactory);
+        const sig = delegateSigningKey.sign(digest);
+        const v = sig.v === 27 ? '1b' : '1c';
+        const delegateSignature = '0x' + sig.r.slice(2) + sig.s.slice(2) + v;
+        return this.http.post('/delegations/sub', {
+            wallet_id: this.walletId,
+            parent_grant_id: options.parentGrantId,
+            delegate: options.to,
+            chains: options.chains,
+            constraints: options.constraints,
+            valid_from: options.validFrom || new Date().toISOString(),
+            valid_until: options.validUntil,
+            sub_delegation: options.subDelegation ?? false,
+            max_sub_depth: options.maxSubDepth ?? 0,
+            activation: options.activation,
+            delegate_signature: delegateSignature,
+            timestamp,
+        });
+    }
+    /**
+     * Revoke a delegation grant (cascading to all sub-grants).
+     */
+    async revoke(delegationId) {
+        const proof = await this.signOwnershipProof('revoke');
+        if (!proof) {
+            throw new errors_1.Sequence0Error('ownerSigner is required to revoke delegation grants');
+        }
+        await this.http.post(`/delegations/${delegationId}/revoke`, {
+            owner_signature: proof.owner_signature,
+            timestamp: proof.timestamp,
+        });
+    }
+    /**
+     * List all delegation grants for this wallet.
+     */
+    async listDelegations() {
+        const res = await this.http.get(`/delegations?wallet_id=${encodeURIComponent(this.walletId)}`);
+        return res.delegations;
+    }
+    /**
+     * Get the delegation tree for this wallet.
+     */
+    async getDelegationTree() {
+        return this.http.get(`/delegations/tree?wallet_id=${encodeURIComponent(this.walletId)}`);
+    }
+    /**
+     * Send heartbeat for dead-man's switch delegation grants.
+     */
+    async heartbeat() {
+        const proof = await this.signOwnershipProof('heartbeat');
+        if (!proof) {
+            throw new errors_1.Sequence0Error('ownerSigner is required for heartbeat');
+        }
+        await this.http.post('/delegations/heartbeat', {
+            wallet_id: this.walletId,
+            owner_signature: proof.owner_signature,
+            timestamp: proof.timestamp,
+        });
+    }
 }
 exports.Wallet = Wallet;
 Wallet.EVM_CHAINS = [