@xkova/sdk 0.1.0-alpha.6 → 0.1.0-alpha.8

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): 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) {
+        return this.deleteJson(`/treasury/wallets/${this.enc(id)}/signers/${this.enc(staffId)}`, opts);
+    }
+    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/workforce-wallets.d.ts

@@ -0,0 +1,34 @@
+import { Resource, type ReqBody } from './base.js';
+import type { XKOVAMutationOptions } from '../client.js';
+/** Current workforce human's canonical wallet, never selected by browser identity. */
+export declare class WorkforceWalletsResource extends Resource {
+    list(): Promise<{
+        data?: import("../generated/types.js").components["schemas"]["StaffMpcWallet"][];
+    }>;
+    /** Fresh exact human proof is required before a provider admission can be issued. */
+    provision(options?: XKOVAMutationOptions): Promise<{
+        mpc_wallet: import("../generated/types.js").components["schemas"]["StaffMpcWallet"];
+        wallet_auth: import("../generated/types.js").components["schemas"]["WalletAdmissionBootstrap"];
+        challenge: {
+            challenge_id: string;
+            nonce: string;
+            typed_data: import("../generated/types.js").components["schemas"]["StaffMpcEnrollmentTypedData"];
+            expires_at: string;
+        };
+    }>;
+    /** Activate only after signing the API's exact one-time enrollment typed data. */
+    register(body: ReqBody<'workforceWalletRegister'>, options?: XKOVAMutationOptions): Promise<{
+        id: import("../generated/types.js").components["schemas"]["StaffMpcWalletId"];
+        staff_id: import("../generated/types.js").components["schemas"]["StaffId"];
+        address: string | null;
+        state: "pending_provisioning" | "active" | "decommissioned";
+        provider_resolution: "pending" | "resolved" | "review_required";
+        created_at: import("../generated/types.js").components["schemas"]["TimestampUtc"];
+        updated_at: import("../generated/types.js").components["schemas"]["TimestampUtc"];
+    }>;
+    /** Binds one ceremony to the current resource's frozen Safe digest and nonce. */
+    signingBootstrap(body: ReqBody<'workforceWalletSigningBootstrap'>, options?: XKOVAMutationOptions): Promise<{
+        mpc_wallet: import("../generated/types.js").components["schemas"]["StaffMpcWallet"];
+        wallet_auth: import("../generated/types.js").components["schemas"]["WalletAdmissionBootstrap"];
+    }>;
+}

package/dist/resources/workforce-wallets.js

@@ -0,0 +1,19 @@
+import { Resource } from './base.js';
+/** Current workforce human's canonical wallet, never selected by browser identity. */
+export class WorkforceWalletsResource extends Resource {
+    list() {
+        return this.getJson('/workforce-auth/me/wallets');
+    }
+    /** Fresh exact human proof is required before a provider admission can be issued. */
+    provision(options) {
+        return this.postJson('/workforce-auth/me/wallets/provision', undefined, options);
+    }
+    /** Activate only after signing the API's exact one-time enrollment typed data. */
+    register(body, options) {
+        return this.postJson('/workforce-auth/me/wallets/register', body, options);
+    }
+    /** Binds one ceremony to the current resource's frozen Safe digest and nonce. */
+    signingBootstrap(body, options) {
+        return this.postJson('/workforce-auth/me/wallets/signing-bootstrap', body, options);
+    }
+}