@xkova/sdk 0.1.0-alpha.1 → 0.1.0-alpha.10

package/dist/resources/treasury.d.ts

@@ -0,0 +1,404 @@
+/** Tenant treasury wallets and transfers. Signer authority is verified by the API. */
+import { Resource, type ReqBody, type Query } from './base.js';
+import type { XKOVAMutationOptions } from '../client.js';
+export declare class TreasuryResource extends Resource {
+    listWallets(query?: Query<'listTreasuryWallets'>): Promise<{
+        data?: import("../generated/types.js").components["schemas"]["TreasuryWallet"][];
+    }>;
+    createWallet(body: ReqBody<'createTreasuryWallet'>, opts?: XKOVAMutationOptions): Promise<{
+        id: import("../generated/types.js").components["schemas"]["TreasuryWalletId"];
+        tenant_id: string;
+        chain_id: string;
+        chain: import("../generated/types.js").components["schemas"]["ChainDescriptor"];
+        address: string;
+        name: string;
+        threshold: number;
+        state: "deploying" | "active" | "decommissioned";
+        is_revenue_treasury: boolean;
+        signers: import("../generated/types.js").components["schemas"]["TreasurySigner"][];
+        deploy_tx_hash: string | null;
+        created_at: import("../generated/types.js").components["schemas"]["TimestampUtc"];
+        updated_at: import("../generated/types.js").components["schemas"]["TimestampUtc"];
+    }>;
+    getWallet(id: string): Promise<{
+        id: import("../generated/types.js").components["schemas"]["TreasuryWalletId"];
+        tenant_id: string;
+        chain_id: string;
+        chain: import("../generated/types.js").components["schemas"]["ChainDescriptor"];
+        address: string;
+        name: string;
+        threshold: number;
+        state: "deploying" | "active" | "decommissioned";
+        is_revenue_treasury: boolean;
+        signers: import("../generated/types.js").components["schemas"]["TreasurySigner"][];
+        deploy_tx_hash: string | null;
+        created_at: import("../generated/types.js").components["schemas"]["TimestampUtc"];
+        updated_at: import("../generated/types.js").components["schemas"]["TimestampUtc"];
+    }>;
+    walletBalance(id: string): Promise<{
+        treasury_wallet_id: import("../generated/types.js").components["schemas"]["TreasuryWalletId"];
+        chain_id: string;
+        balances: import("../generated/types.js").components["schemas"]["TreasuryBalance"][];
+        fetched_at: string;
+    }>;
+    listSigners(id: string): Promise<{
+        data?: import("../generated/types.js").components["schemas"]["TreasurySigner"][];
+    }>;
+    addSigner(id: string, body: ReqBody<'addTreasurySigner'>, opts?: XKOVAMutationOptions): Promise<{
+        status: "pending_approval";
+        pending_approval_request_id: import("../generated/types.js").components["schemas"]["ApprovalRequestId"];
+    } | {
+        wallet: import("../generated/types.js").components["schemas"]["TreasuryWallet"];
+        draft_transfer_id: import("../generated/types.js").components["schemas"]["TreasuryTransferId"];
+    }>;
+    changeThreshold(id: string, body: ReqBody<'changeTreasuryThreshold'>, opts?: XKOVAMutationOptions): Promise<{
+        status: "pending_approval";
+        pending_approval_request_id: import("../generated/types.js").components["schemas"]["ApprovalRequestId"];
+    } | {
+        wallet: import("../generated/types.js").components["schemas"]["TreasuryWallet"];
+        draft_transfer_id: import("../generated/types.js").components["schemas"]["TreasuryTransferId"];
+    }>;
+    listTransfers(walletId: string, query?: Query<'listTreasuryTransfers'>): Promise<{
+        data: unknown[];
+        next_cursor: string | null;
+        has_more: boolean;
+    } & {
+        data?: import("../generated/types.js").components["schemas"]["TreasuryTransfer"][];
+    }>;
+    draftTransfer(walletId: string, body: ReqBody<'draftTreasuryTransfer'>, opts?: XKOVAMutationOptions): Promise<{
+        id: import("../generated/types.js").components["schemas"]["TreasuryTransferId"];
+        treasury_wallet_id: import("../generated/types.js").components["schemas"]["TreasuryWalletId"];
+        chain: import("../generated/types.js").components["schemas"]["ChainDescriptor"];
+        initiated_by_staff_id: import("../generated/types.js").components["schemas"]["StaffId"];
+        kind: import("../generated/types.js").components["schemas"]["TreasuryTransferKind"];
+        to_address: string;
+        asset_token_address: string | null;
+        amount: string | null;
+        safe_nonce: string;
+        safe_tx_hash: string;
+        state: import("../generated/types.js").components["schemas"]["TreasuryTransferState"];
+        memo?: string | null;
+        tax_classification?: string | null;
+        counterparty_id?: import("../generated/types.js").components["schemas"]["TreasuryCounterpartyId"] | null;
+        signatures: import("../generated/types.js").components["schemas"]["TreasuryTransferSignature"][];
+        threshold: number;
+        threshold_met: boolean;
+        signing_context?: import("../generated/types.js").components["schemas"]["TreasuryTransferSigningContext"] | null;
+        execute_tx_hash: string | null;
+        failure_reason_code: string | null;
+        failure_reason_detail: string | null;
+        failure_retryable: boolean;
+        created_at: import("../generated/types.js").components["schemas"]["TimestampUtc"];
+        executed_at: string | null;
+        confirmed_at: string | null;
+    }>;
+    getTransfer(id: string, query?: Query<'getTreasuryTransfer'>): Promise<{
+        id: import("../generated/types.js").components["schemas"]["TreasuryTransferId"];
+        treasury_wallet_id: import("../generated/types.js").components["schemas"]["TreasuryWalletId"];
+        chain: import("../generated/types.js").components["schemas"]["ChainDescriptor"];
+        initiated_by_staff_id: import("../generated/types.js").components["schemas"]["StaffId"];
+        kind: import("../generated/types.js").components["schemas"]["TreasuryTransferKind"];
+        to_address: string;
+        asset_token_address: string | null;
+        amount: string | null;
+        safe_nonce: string;
+        safe_tx_hash: string;
+        state: import("../generated/types.js").components["schemas"]["TreasuryTransferState"];
+        memo?: string | null;
+        tax_classification?: string | null;
+        counterparty_id?: import("../generated/types.js").components["schemas"]["TreasuryCounterpartyId"] | null;
+        signatures: import("../generated/types.js").components["schemas"]["TreasuryTransferSignature"][];
+        threshold: number;
+        threshold_met: boolean;
+        signing_context?: import("../generated/types.js").components["schemas"]["TreasuryTransferSigningContext"] | null;
+        execute_tx_hash: string | null;
+        failure_reason_code: string | null;
+        failure_reason_detail: string | null;
+        failure_retryable: boolean;
+        created_at: import("../generated/types.js").components["schemas"]["TimestampUtc"];
+        executed_at: string | null;
+        confirmed_at: string | null;
+    }>;
+    submitTransferSignature(id: string, body: ReqBody<'submitTreasuryTransferSignature'>, opts?: XKOVAMutationOptions): Promise<{
+        id: import("../generated/types.js").components["schemas"]["TreasuryTransferId"];
+        treasury_wallet_id: import("../generated/types.js").components["schemas"]["TreasuryWalletId"];
+        chain: import("../generated/types.js").components["schemas"]["ChainDescriptor"];
+        initiated_by_staff_id: import("../generated/types.js").components["schemas"]["StaffId"];
+        kind: import("../generated/types.js").components["schemas"]["TreasuryTransferKind"];
+        to_address: string;
+        asset_token_address: string | null;
+        amount: string | null;
+        safe_nonce: string;
+        safe_tx_hash: string;
+        state: import("../generated/types.js").components["schemas"]["TreasuryTransferState"];
+        memo?: string | null;
+        tax_classification?: string | null;
+        counterparty_id?: import("../generated/types.js").components["schemas"]["TreasuryCounterpartyId"] | null;
+        signatures: import("../generated/types.js").components["schemas"]["TreasuryTransferSignature"][];
+        threshold: number;
+        threshold_met: boolean;
+        signing_context?: import("../generated/types.js").components["schemas"]["TreasuryTransferSigningContext"] | null;
+        execute_tx_hash: string | null;
+        failure_reason_code: string | null;
+        failure_reason_detail: string | null;
+        failure_retryable: boolean;
+        created_at: import("../generated/types.js").components["schemas"]["TimestampUtc"];
+        executed_at: string | null;
+        confirmed_at: string | null;
+    }>;
+    executeTransfer(id: string, opts?: XKOVAMutationOptions): Promise<{
+        id: import("../generated/types.js").components["schemas"]["TreasuryTransferId"];
+        treasury_wallet_id: import("../generated/types.js").components["schemas"]["TreasuryWalletId"];
+        chain: import("../generated/types.js").components["schemas"]["ChainDescriptor"];
+        initiated_by_staff_id: import("../generated/types.js").components["schemas"]["StaffId"];
+        kind: import("../generated/types.js").components["schemas"]["TreasuryTransferKind"];
+        to_address: string;
+        asset_token_address: string | null;
+        amount: string | null;
+        safe_nonce: string;
+        safe_tx_hash: string;
+        state: import("../generated/types.js").components["schemas"]["TreasuryTransferState"];
+        memo?: string | null;
+        tax_classification?: string | null;
+        counterparty_id?: import("../generated/types.js").components["schemas"]["TreasuryCounterpartyId"] | null;
+        signatures: import("../generated/types.js").components["schemas"]["TreasuryTransferSignature"][];
+        threshold: number;
+        threshold_met: boolean;
+        signing_context?: import("../generated/types.js").components["schemas"]["TreasuryTransferSigningContext"] | null;
+        execute_tx_hash: string | null;
+        failure_reason_code: string | null;
+        failure_reason_detail: string | null;
+        failure_retryable: boolean;
+        created_at: import("../generated/types.js").components["schemas"]["TimestampUtc"];
+        executed_at: string | null;
+        confirmed_at: string | null;
+    }>;
+    cancelTransfer(id: string, opts?: XKOVAMutationOptions): Promise<{
+        id: import("../generated/types.js").components["schemas"]["TreasuryTransferId"];
+        treasury_wallet_id: import("../generated/types.js").components["schemas"]["TreasuryWalletId"];
+        chain: import("../generated/types.js").components["schemas"]["ChainDescriptor"];
+        initiated_by_staff_id: import("../generated/types.js").components["schemas"]["StaffId"];
+        kind: import("../generated/types.js").components["schemas"]["TreasuryTransferKind"];
+        to_address: string;
+        asset_token_address: string | null;
+        amount: string | null;
+        safe_nonce: string;
+        safe_tx_hash: string;
+        state: import("../generated/types.js").components["schemas"]["TreasuryTransferState"];
+        memo?: string | null;
+        tax_classification?: string | null;
+        counterparty_id?: import("../generated/types.js").components["schemas"]["TreasuryCounterpartyId"] | null;
+        signatures: import("../generated/types.js").components["schemas"]["TreasuryTransferSignature"][];
+        threshold: number;
+        threshold_met: boolean;
+        signing_context?: import("../generated/types.js").components["schemas"]["TreasuryTransferSigningContext"] | null;
+        execute_tx_hash: string | null;
+        failure_reason_code: string | null;
+        failure_reason_detail: string | null;
+        failure_retryable: boolean;
+        created_at: import("../generated/types.js").components["schemas"]["TimestampUtc"];
+        executed_at: string | null;
+        confirmed_at: string | null;
+    }>;
+    decommissionWallet(id: string, opts?: XKOVAMutationOptions): Promise<void>;
+    designateRevenueWallet(id: string, opts?: XKOVAMutationOptions): Promise<{
+        status: "pending_approval";
+        pending_approval_request_id: import("../generated/types.js").components["schemas"]["ApprovalRequestId"];
+    } | {
+        id: import("../generated/types.js").components["schemas"]["TreasuryWalletId"];
+        tenant_id: string;
+        chain_id: string;
+        chain: import("../generated/types.js").components["schemas"]["ChainDescriptor"];
+        address: string;
+        name: string;
+        threshold: number;
+        state: "deploying" | "active" | "decommissioned";
+        is_revenue_treasury: boolean;
+        signers: import("../generated/types.js").components["schemas"]["TreasurySigner"][];
+        deploy_tx_hash: string | null;
+        created_at: import("../generated/types.js").components["schemas"]["TimestampUtc"];
+        updated_at: import("../generated/types.js").components["schemas"]["TimestampUtc"];
+    }>;
+    deleteSigner(id: string, staffId: string, opts?: XKOVAMutationOptions, query?: Query<'removeTreasurySigner'>): Promise<{
+        status: "pending_approval";
+        pending_approval_request_id: import("../generated/types.js").components["schemas"]["ApprovalRequestId"];
+    } | {
+        wallet: import("../generated/types.js").components["schemas"]["TreasuryWallet"];
+        draft_transfer_id: import("../generated/types.js").components["schemas"]["TreasuryTransferId"];
+    }>;
+    walletTransactions(id: string, query?: Query<'getTreasuryWalletTransactions'>): Promise<{
+        data: unknown[];
+        next_cursor: string | null;
+        has_more: boolean;
+    } & {
+        data?: import("../generated/types.js").components["schemas"]["TreasuryTransfer"][];
+    }>;
+    listNftHoldings(walletId: string, query?: Query<'listTreasuryNftHoldings'>): Promise<{
+        data: import("../generated/types.js").components["schemas"]["TreasuryNftHolding"][];
+        next_cursor: string | null;
+        has_more: boolean;
+    }>;
+    draftNftTransfer(walletId: string, body: ReqBody<'draftTreasuryNftTransfer'>, opts?: XKOVAMutationOptions): Promise<{
+        id: import("../generated/types.js").components["schemas"]["TreasuryTransferId"];
+        treasury_wallet_id: import("../generated/types.js").components["schemas"]["TreasuryWalletId"];
+        chain: import("../generated/types.js").components["schemas"]["ChainDescriptor"];
+        initiated_by_staff_id: import("../generated/types.js").components["schemas"]["StaffId"];
+        kind: import("../generated/types.js").components["schemas"]["TreasuryTransferKind"];
+        to_address: string;
+        asset_token_address: string | null;
+        amount: string | null;
+        safe_nonce: string;
+        safe_tx_hash: string;
+        state: import("../generated/types.js").components["schemas"]["TreasuryTransferState"];
+        memo?: string | null;
+        tax_classification?: string | null;
+        counterparty_id?: import("../generated/types.js").components["schemas"]["TreasuryCounterpartyId"] | null;
+        signatures: import("../generated/types.js").components["schemas"]["TreasuryTransferSignature"][];
+        threshold: number;
+        threshold_met: boolean;
+        signing_context?: import("../generated/types.js").components["schemas"]["TreasuryTransferSigningContext"] | null;
+        execute_tx_hash: string | null;
+        failure_reason_code: string | null;
+        failure_reason_detail: string | null;
+        failure_retryable: boolean;
+        created_at: import("../generated/types.js").components["schemas"]["TimestampUtc"];
+        executed_at: string | null;
+        confirmed_at: string | null;
+    }>;
+    listAssets(query: Query<'listTreasuryAssets'>): Promise<{
+        data?: import("../generated/types.js").components["schemas"]["TreasuryAsset"][];
+    }>;
+    listCounterparties(query?: Query<'listTreasuryCounterparties'>): Promise<{
+        data: unknown[];
+        next_cursor: string | null;
+        has_more: boolean;
+    } & {
+        data?: import("../generated/types.js").components["schemas"]["TreasuryCounterparty"][];
+    }>;
+    createCounterparty(body: ReqBody<'createTreasuryCounterparty'>, opts?: XKOVAMutationOptions): Promise<{
+        status: "pending_approval";
+        pending_approval_request_id: import("../generated/types.js").components["schemas"]["ApprovalRequestId"];
+    } | {
+        id: import("../generated/types.js").components["schemas"]["TreasuryCounterpartyId"];
+        display_name: string;
+        legal_name: string | null;
+        tax_id: string | null;
+        tax_id_type: "ein" | "ssn" | "foreign" | "none";
+        classification_default: string | null;
+        addresses: import("../generated/types.js").components["schemas"]["TreasuryCounterpartyAddress"][];
+        created_at: import("../generated/types.js").components["schemas"]["TimestampUtc"];
+        updated_at: import("../generated/types.js").components["schemas"]["TimestampUtc"];
+    }>;
+    updateCounterparty(id: string, body: ReqBody<'updateTreasuryCounterparty'>, opts?: XKOVAMutationOptions): Promise<{
+        id: import("../generated/types.js").components["schemas"]["TreasuryCounterpartyId"];
+        display_name: string;
+        legal_name: string | null;
+        tax_id: string | null;
+        tax_id_type: "ein" | "ssn" | "foreign" | "none";
+        classification_default: string | null;
+        addresses: import("../generated/types.js").components["schemas"]["TreasuryCounterpartyAddress"][];
+        created_at: import("../generated/types.js").components["schemas"]["TimestampUtc"];
+        updated_at: import("../generated/types.js").components["schemas"]["TimestampUtc"];
+    }>;
+    addCounterpartyAddress(id: string, body: ReqBody<'addTreasuryCounterpartyAddress'>, opts?: XKOVAMutationOptions): Promise<{
+        id: import("../generated/types.js").components["schemas"]["TreasuryCounterpartyAddressId"];
+        chain_id: string;
+        address: string;
+        added_at: import("../generated/types.js").components["schemas"]["TimestampUtc"];
+    }>;
+    deleteCounterpartyAddress(id: string, addressId: string, opts?: XKOVAMutationOptions): Promise<void>;
+    listRevenueChanges(): Promise<{
+        data: import("../generated/types.js").components["schemas"]["RevenueTreasuryChange"][];
+    }>;
+    createRevenueChange(body: ReqBody<'createRevenueTreasuryChange'>, opts?: XKOVAMutationOptions): Promise<{
+        id: import("../generated/types.js").components["schemas"]["RevenueTreasuryChangeId"];
+        from_treasury_wallet_id: import("../generated/types.js").components["schemas"]["TreasuryWalletId"];
+        to_treasury_wallet_id: import("../generated/types.js").components["schemas"]["TreasuryWalletId"];
+        required_approvals: number;
+        signature_count: number;
+        state: "open" | "partially_approved" | "ready_to_apply" | "applied" | "cancelled";
+        signatures: import("../generated/types.js").components["schemas"]["RevenueTreasuryChangeSignature"][];
+        signing_context: {
+            [key: string]: unknown;
+        };
+        created_at: import("../generated/types.js").components["schemas"]["TimestampUtc"];
+        approved_at: string | null;
+        applied_at: string | null;
+        cancelled_at: string | null;
+    } | {
+        status: "pending_approval";
+        pending_approval_request_id: import("../generated/types.js").components["schemas"]["ApprovalRequestId"];
+    }>;
+    getRevenueChange(id: string): Promise<{
+        id: import("../generated/types.js").components["schemas"]["RevenueTreasuryChangeId"];
+        from_treasury_wallet_id: import("../generated/types.js").components["schemas"]["TreasuryWalletId"];
+        to_treasury_wallet_id: import("../generated/types.js").components["schemas"]["TreasuryWalletId"];
+        required_approvals: number;
+        signature_count: number;
+        state: "open" | "partially_approved" | "ready_to_apply" | "applied" | "cancelled";
+        signatures: import("../generated/types.js").components["schemas"]["RevenueTreasuryChangeSignature"][];
+        signing_context: {
+            [key: string]: unknown;
+        };
+        created_at: import("../generated/types.js").components["schemas"]["TimestampUtc"];
+        approved_at: string | null;
+        applied_at: string | null;
+        cancelled_at: string | null;
+    }>;
+    applyRevenueChange(id: string, opts?: XKOVAMutationOptions): Promise<{
+        id: import("../generated/types.js").components["schemas"]["RevenueTreasuryChangeId"];
+        from_treasury_wallet_id: import("../generated/types.js").components["schemas"]["TreasuryWalletId"];
+        to_treasury_wallet_id: import("../generated/types.js").components["schemas"]["TreasuryWalletId"];
+        required_approvals: number;
+        signature_count: number;
+        state: "open" | "partially_approved" | "ready_to_apply" | "applied" | "cancelled";
+        signatures: import("../generated/types.js").components["schemas"]["RevenueTreasuryChangeSignature"][];
+        signing_context: {
+            [key: string]: unknown;
+        };
+        created_at: import("../generated/types.js").components["schemas"]["TimestampUtc"];
+        approved_at: string | null;
+        applied_at: string | null;
+        cancelled_at: string | null;
+    }>;
+    cancelRevenueChange(id: string, opts?: XKOVAMutationOptions): Promise<{
+        id: import("../generated/types.js").components["schemas"]["RevenueTreasuryChangeId"];
+        from_treasury_wallet_id: import("../generated/types.js").components["schemas"]["TreasuryWalletId"];
+        to_treasury_wallet_id: import("../generated/types.js").components["schemas"]["TreasuryWalletId"];
+        required_approvals: number;
+        signature_count: number;
+        state: "open" | "partially_approved" | "ready_to_apply" | "applied" | "cancelled";
+        signatures: import("../generated/types.js").components["schemas"]["RevenueTreasuryChangeSignature"][];
+        signing_context: {
+            [key: string]: unknown;
+        };
+        created_at: import("../generated/types.js").components["schemas"]["TimestampUtc"];
+        approved_at: string | null;
+        applied_at: string | null;
+        cancelled_at: string | null;
+    }>;
+    signRevenueChange(id: string, body: ReqBody<'signRevenueTreasuryChange'>, opts?: XKOVAMutationOptions): Promise<{
+        id: import("../generated/types.js").components["schemas"]["RevenueTreasuryChangeId"];
+        from_treasury_wallet_id: import("../generated/types.js").components["schemas"]["TreasuryWalletId"];
+        to_treasury_wallet_id: import("../generated/types.js").components["schemas"]["TreasuryWalletId"];
+        required_approvals: number;
+        signature_count: number;
+        state: "open" | "partially_approved" | "ready_to_apply" | "applied" | "cancelled";
+        signatures: import("../generated/types.js").components["schemas"]["RevenueTreasuryChangeSignature"][];
+        signing_context: {
+            [key: string]: unknown;
+        };
+        created_at: import("../generated/types.js").components["schemas"]["TimestampUtc"];
+        approved_at: string | null;
+        applied_at: string | null;
+        cancelled_at: string | null;
+    }>;
+    tax1099Summary(query: Query<'getTax1099Summary'>): Promise<{
+        year: number;
+        counterparties: import("../generated/types.js").components["schemas"]["Tax1099SummaryRow"][];
+    }>;
+    /** 1099-MISC as raw CSV. */
+    tax1099Csv(query: Query<'getTax1099Csv'>): Promise<string>;
+    /** Treasury transactions as raw CSV. */
+    taxTransactionsCsv(query: Query<'getTaxTransactionsCsv'>): Promise<string>;
+}

package/dist/resources/treasury.js

@@ -0,0 +1,115 @@
+/** Tenant treasury wallets and transfers. Signer authority is verified by the API. */
+import { Resource } from './base.js';
+export class TreasuryResource extends Resource {
+    // ── Wallets (Safes) ──────────────────────────────────────────────
+    listWallets(query = {}) {
+        return this.getJson('/treasury/wallets', query);
+    }
+    createWallet(body, opts) {
+        return this.postJson('/treasury/wallets', body, opts);
+    }
+    getWallet(id) {
+        return this.getJson(`/treasury/wallets/${this.enc(id)}`);
+    }
+    walletBalance(id) {
+        return this.getJson(`/treasury/wallets/${this.enc(id)}/balance`);
+    }
+    listSigners(id) {
+        return this.getJson(`/treasury/wallets/${this.enc(id)}/signers`);
+    }
+    addSigner(id, body, opts) {
+        return this.postJson(`/treasury/wallets/${this.enc(id)}/signers`, body, opts);
+    }
+    changeThreshold(id, body, opts) {
+        return this.postJson(`/treasury/wallets/${this.enc(id)}/threshold`, body, opts);
+    }
+    // ── Transfers (draft → sign → execute) ───────────────────────────
+    listTransfers(walletId, query = {}) {
+        return this.getJson(`/treasury/wallets/${this.enc(walletId)}/transfers`, query);
+    }
+    draftTransfer(walletId, body, opts) {
+        return this.postJson(`/treasury/wallets/${this.enc(walletId)}/transfers`, body, opts);
+    }
+    getTransfer(id, query = {}) {
+        return this.getJson(`/treasury/transfers/${this.enc(id)}`, query);
+    }
+    submitTransferSignature(id, body, opts) {
+        return this.postJson(`/treasury/transfers/${this.enc(id)}/signatures`, body, opts);
+    }
+    executeTransfer(id, opts) {
+        return this.postJson(`/treasury/transfers/${this.enc(id)}/execute`, undefined, opts);
+    }
+    cancelTransfer(id, opts) {
+        return this.postJson(`/treasury/transfers/${this.enc(id)}/cancel`, undefined, opts);
+    }
+    // ── Wallet lifecycle + NFT holdings ──────────────────────────────
+    decommissionWallet(id, opts) {
+        return this.postJson(`/treasury/wallets/${this.enc(id)}/decommission`, undefined, opts);
+    }
+    designateRevenueWallet(id, opts) {
+        return this.postJson(`/treasury/wallets/${this.enc(id)}/designate-revenue`, undefined, opts);
+    }
+    deleteSigner(id, staffId, opts, query = {}) {
+        return this.deleteJson(`/treasury/wallets/${this.enc(id)}/signers/${this.enc(staffId)}`, opts, query);
+    }
+    walletTransactions(id, query = {}) {
+        return this.getJson(`/treasury/wallets/${this.enc(id)}/transactions`, query);
+    }
+    listNftHoldings(walletId, query = {}) {
+        return this.getJson(`/treasury/wallets/${this.enc(walletId)}/nft-holdings`, query);
+    }
+    draftNftTransfer(walletId, body, opts) {
+        return this.postJson(`/treasury/wallets/${this.enc(walletId)}/nft-transfers`, body, opts);
+    }
+    // ── Available assets ─────────────────────────────────────────────
+    listAssets(query) {
+        return this.getJson('/treasury/assets', query);
+    }
+    // ── Counterparties ───────────────────────────────────────────────
+    listCounterparties(query = {}) {
+        return this.getJson('/treasury/counterparties', query);
+    }
+    createCounterparty(body, opts) {
+        return this.postJson('/treasury/counterparties', body, opts);
+    }
+    updateCounterparty(id, body, opts) {
+        return this.patchJson(`/treasury/counterparties/${this.enc(id)}`, body, opts);
+    }
+    addCounterpartyAddress(id, body, opts) {
+        return this.postJson(`/treasury/counterparties/${this.enc(id)}/addresses`, body, opts);
+    }
+    deleteCounterpartyAddress(id, addressId, opts) {
+        return this.deleteJson(`/treasury/counterparties/${this.enc(id)}/addresses/${this.enc(addressId)}`, opts);
+    }
+    // ── Revenue-treasury change ceremonies ───────────────────────────
+    listRevenueChanges() {
+        return this.getJson('/treasury/revenue-changes');
+    }
+    createRevenueChange(body, opts) {
+        return this.postJson('/treasury/revenue-changes', body, opts);
+    }
+    getRevenueChange(id) {
+        return this.getJson(`/treasury/revenue-changes/${this.enc(id)}`);
+    }
+    applyRevenueChange(id, opts) {
+        return this.postJson(`/treasury/revenue-changes/${this.enc(id)}/apply`, undefined, opts);
+    }
+    cancelRevenueChange(id, opts) {
+        return this.postJson(`/treasury/revenue-changes/${this.enc(id)}/cancel`, undefined, opts);
+    }
+    signRevenueChange(id, body, opts) {
+        return this.postJson(`/treasury/revenue-changes/${this.enc(id)}/signatures`, body, opts);
+    }
+    // ── Tax exports ──────────────────────────────────────────────────
+    tax1099Summary(query) {
+        return this.getJson('/treasury/tax/1099-summary', query);
+    }
+    /** 1099-MISC as raw CSV. */
+    tax1099Csv(query) {
+        return this.getText('/treasury/tax/1099-misc.csv', query);
+    }
+    /** Treasury transactions as raw CSV. */
+    taxTransactionsCsv(query) {
+        return this.getText('/treasury/tax/transactions.csv', query);
+    }
+}

package/dist/resources/wallets.d.ts

@@ -16,6 +16,7 @@ export declare class WalletsResource extends Resource {
         updated_at: import("../generated/types.js").components["schemas"]["TimestampUtc"];
     }>;
     balance(id: string, query: Query<'getWalletBalance'>): Promise<{
+        data_freshness: import("../generated/types.js").components["schemas"]["DataFreshness"][];
         chain_id: number;
         wallet: string;
         token: string;
@@ -34,6 +35,7 @@ export declare class WalletsResource extends Resource {
         has_more: boolean;
     } & {
         data?: import("../generated/types.js").components["schemas"]["LedgerEntry"][];
+        data_freshness: import("../generated/types.js").components["schemas"]["DataFreshness"][];
     }>;
     decommission(id: string, opts?: XKOVAMutationOptions): Promise<{
         id: import("../generated/types.js").components["schemas"]["WalletId"];

package/dist/resources/webhooks.d.ts

@@ -48,7 +48,7 @@ export declare class WebhooksResource extends Resource {
         updated_at?: import("../generated/types.js").components["schemas"]["TimestampUtc"];
     }>;
     delete(id: string, opts?: XKOVAMutationOptions): Promise<void>;
-    rotateSecret(id: string, opts?: XKOVAMutationOptions): Promise<{
+    rotateSecret(id: string, opts?: XKOVAMutationOptions, body?: ReqBody<'rotateWebhookEndpointSecret'>): Promise<{
         id?: import("../generated/types.js").components["schemas"]["WebhookEndpointId"];
         url?: string;
         events?: string[];

package/dist/resources/webhooks.js

@@ -19,8 +19,8 @@ export class WebhooksResource extends Resource {
     delete(id, opts) {
         return this.deleteJson(`/webhook-endpoints/${this.enc(id)}`, opts);
     }
-    rotateSecret(id, opts) {
-        return this.postJson(`/webhook-endpoints/${this.enc(id)}/rotate`, undefined, opts);
+    rotateSecret(id, opts, body) {
+        return this.postJson(`/webhook-endpoints/${this.enc(id)}/rotate`, body, opts);
     }
     test(id, opts) {
         return this.postJson(`/webhook-endpoints/${this.enc(id)}/test`, undefined, opts);

package/dist/resources/workflows.d.ts

@@ -16,8 +16,9 @@ export declare class WorkflowClient {
     private readonly client;
     constructor(client: XKOVAClient);
     /**
-     * Deploy a token and wait for on-chain confirmation.
-     * The deploy poller auto-registers the token on the payment router.
+     * Submit deployment once and observe the exact customer token until active.
+     * The returned operation ID is diagnostic; deployment operations are not
+     * available through the operation read API.
      */
     tokenDeploy(standard: 'erc20', body: ReqBody<'deployCustomerErc20'>, opts?: XKOVAMutationOptions & {
         poll?: PollOptions;
@@ -28,14 +29,14 @@ export declare class WorkflowClient {
     tokenDeploy(standard: 'erc1155', body: ReqBody<'deployCustomerErc1155'>, opts?: XKOVAMutationOptions & {
         poll?: PollOptions;
     }): Promise<Ok<'getCustomerToken'>>;
-    /** Mint to a holder and wait for confirmation. */
+    /** Submit once and observe the exact mint operation. Required human signing remains separate. */
     tokenMint(tokenId: string, body: ReqBody<'mintCustomerToken'>, opts?: XKOVAMutationOptions & {
         poll?: PollOptions;
     }): Promise<Ok<'getCustomerToken'>>;
     /**
-     * Off-ramp: resolve the burn address and create the request. The member then
-     * burns stablecoin to the returned address out-of-band; poll
-     * `client.ramps.getOffRamp(id)` for settlement.
+     * Resolve the registered burn address and create the caller's burn-backed
+     * request. This helper does not submit a transaction or establish settlement;
+     * poll `client.ramps.getOffRamp(id)` for the resulting request's state.
      */
     offRampInitiate(chainRef: string, body: ReqBody<'createOffRampRequest'>, opts?: XKOVAMutationOptions): Promise<{
         request: Ok<'createOffRampRequest'>;