@dexterai/vault 0.4.2 → 0.6.0

package/dist/instructions/index.d.cts

@@ -394,4 +394,175 @@ declare function deriveVaultPda(supabaseUserId: Uint8Array): {
     bump: number;
 };
 
-export { type BuildRegisterSessionKeyArgs, type BuildRevokeSessionKeyArgs, type BuildSetSwigAtomicFromIdentityParams, type BuildSetSwigAtomicParams, type BuildSwigCreationBundleParams, type FinalizeWithdrawalParams, type ForceReleaseParams, type InitializeVaultParams, type ProvePasskeyParams, type RequestWithdrawalParams, type RotateDexterAuthorityParams, type RotatePasskeyParams, SET_SWIG_ATOMIC_DISCRIMINATOR, SWIG_PROGRAM_EXEC_MARKERS, SWIG_PROGRAM_EXEC_PREFIX, SWIG_PROGRAM_EXEC_PREFIX_SETTLE_TAB, type SetSwigParams, type SettleTabVoucherParams, type SettleVoucherParams, type SwigCreationBundleOutput, type SwigOwnershipCheck, buildFinalizeWithdrawalInstruction, buildForceReleaseInstruction, buildInitializeVaultInstruction, buildProvePasskeyInstruction, buildRegisterSessionKeyInstruction, buildRequestWithdrawalInstruction, buildRevokeSessionKeyInstruction, buildRotateDexterAuthorityInstruction, buildRotatePasskeyInstruction, buildSetSwigAtomicFromIdentity, buildSetSwigAtomicInstruction, buildSetSwigInstruction, buildSettleTabVoucherInstruction, buildSettleVoucherInstruction, buildSwigCreationBundle, deriveSwigId, deriveSwigWalletAddress, deriveVaultPda, expectedSwigAddressFor, verifySwigIsOurs };
+/**
+ * LockedClaim instruction builders — the claim lifecycle.
+ * Mirrors the on-chain Anchor structs in
+ * programs/dexter-vault/src/instructions/{lock_voucher,settle_locked_voucher,
+ * transfer_lock_ownership,recover_abandoned_lock}.rs. Account ordering is
+ * consensus-critical and MUST match the program exactly.
+ */
+
+interface TransferLockOwnershipParams {
+    claimPda: PublicKey;
+    currentHolder: PublicKey;
+    newHolder: PublicKey;
+}
+/**
+ * Account order MUST match the on-chain struct:
+ *   [0] claim          (writable)
+ *   [1] current_holder (signer)
+ * Data: discriminator || new_holder (32-byte pubkey).
+ */
+declare function buildTransferLockOwnershipInstruction(p: TransferLockOwnershipParams): TransactionInstruction;
+interface SettleLockedVoucherParams {
+    swigAddress: PublicKey;
+    claimPda: PublicKey;
+    vaultPda: PublicKey;
+    holder: PublicKey;
+    dexterAuthority: PublicKey;
+}
+/**
+ * Account order MUST match the on-chain struct:
+ *   [0] swig                (readonly, == vault.swig_address)
+ *   [1] swig_wallet_address (readonly, PDA derived from swig)
+ *   [2] claim               (writable)
+ *   [3] vault               (writable)
+ *   [4] holder              (signer — the current claim holder collecting)
+ *   [5] dexter_authority    (signer)
+ * Data: discriminator only (SettleLockedVoucherArgs is empty).
+ */
+declare function buildSettleLockedVoucherInstruction(p: SettleLockedVoucherParams): TransactionInstruction;
+interface RecoverAbandonedLockParams {
+    claimPda: PublicKey;
+    vaultPda: PublicKey;
+    clientDataJSON: Uint8Array;
+    authenticatorData: Uint8Array;
+}
+/**
+ * Account order MUST match the on-chain struct:
+ *   [0] claim               (writable)
+ *   [1] vault               (writable)
+ *   [2] instructions_sysvar (readonly)
+ * Data: discriminator || vec(client_data_json) || vec(authenticator_data).
+ */
+declare function buildRecoverAbandonedLockInstruction(p: RecoverAbandonedLockParams): TransactionInstruction;
+/** LockedClaim PDA: [LOCKED_CLAIM_SEED, vault, voucher_hash] under the vault program. */
+declare function deriveLockedClaimPda(vaultPda: PublicKey, voucherHash: Uint8Array): PublicKey;
+interface LockVoucherParams {
+    vaultPda: PublicKey;
+    vaultUsdcAta: PublicKey;
+    swigAddress: PublicKey;
+    sellerHolder: PublicKey;
+    dexterAuthority: PublicKey;
+    payer: PublicKey;
+    channelId: Uint8Array;
+    cumulativeAmount: bigint;
+    sequenceNumber: number;
+    voucherHash: Uint8Array;
+    maturityAt: bigint | null;
+    holderRecoveryAt: bigint | null;
+}
+/**
+ * Account order MUST match the on-chain struct:
+ *   [0] vault               (writable)
+ *   [1] vault_usdc_ata      (readonly)
+ *   [2] swig                (readonly)
+ *   [3] swig_wallet_address (readonly, PDA)
+ *   [4] claim               (writable, PDA [LOCKED_CLAIM_SEED, vault, voucher_hash])
+ *   [5] seller_holder       (signer)
+ *   [6] dexter_authority    (signer)
+ *   [7] payer               (signer, writable)
+ *   [8] system_program      (readonly)
+ *   [9] instructions_sysvar (readonly)
+ * Data: disc || channel_id(32) || cumulative(u64) || sequence(u32)
+ *       || voucher_hash(32) || option_i64(maturity_at) || option_i64(holder_recovery_at)
+ */
+declare function buildLockVoucherInstruction(p: LockVoucherParams): TransactionInstruction;
+
+/**
+ * Credit-L2 instruction builders — the standby-credit lifecycle.
+ * Mirrors the on-chain Anchor structs in
+ * programs/dexter-vault/src/instructions/{open_standby,draw_credit,repay_credit,
+ * seize_collateral,migrate_v4_to_v5}.rs. Account ordering is consensus-critical
+ * and MUST match the program exactly.
+ */
+
+interface OpenStandbyParams {
+    vaultPda: PublicKey;
+    financierSwig: PublicKey;
+    cap: bigint;
+    clientDataJSON: Uint8Array;
+    authenticatorData: Uint8Array;
+}
+/**
+ * Account order MUST match the on-chain struct:
+ *   [0] vault               (writable)
+ *   [1] financier_swig      (readonly)
+ *   [2] instructions_sysvar (readonly)
+ * Data: disc || cap(u64) || vec(client_data_json) || vec(authenticator_data).
+ */
+declare function buildOpenStandbyInstruction(p: OpenStandbyParams): TransactionInstruction;
+interface DrawCreditParams {
+    financierSwig: PublicKey;
+    vaultPda: PublicKey;
+    dexterAuthority: PublicKey;
+    amount: bigint;
+    recoveryWindowSeconds: bigint;
+}
+/**
+ * Account order MUST match the on-chain struct:
+ *   [0] financier_swig                (readonly)
+ *   [1] financier_swig_wallet_address (readonly, PDA derived from financier_swig)
+ *   [2] vault                         (writable)
+ *   [3] dexter_authority              (signer)
+ *   [4] instructions_sysvar           (readonly)
+ * Data: disc || amount(u64) || recovery_window_seconds(i64).
+ */
+declare function buildDrawCreditInstruction(p: DrawCreditParams): TransactionInstruction;
+interface RepayCreditParams {
+    swigAddress: PublicKey;
+    vaultPda: PublicKey;
+    dexterAuthority: PublicKey;
+    amount: bigint;
+}
+/**
+ * Account order MUST match the on-chain struct:
+ *   [0] swig                (readonly, the USER's swig)
+ *   [1] swig_wallet_address (readonly, PDA derived from swig)
+ *   [2] vault               (writable)
+ *   [3] dexter_authority    (signer)
+ *   [4] instructions_sysvar (readonly)
+ * Data: disc || amount(u64).
+ */
+declare function buildRepayCreditInstruction(p: RepayCreditParams): TransactionInstruction;
+interface SeizeCollateralParams {
+    swigAddress: PublicKey;
+    vaultPda: PublicKey;
+    dexterAuthority: PublicKey;
+}
+/**
+ * Account order MUST match the on-chain struct:
+ *   [0] swig                (readonly, the USER's swig)
+ *   [1] swig_wallet_address (readonly, PDA derived from swig)
+ *   [2] vault               (writable)
+ *   [3] dexter_authority    (signer)
+ *   [4] instructions_sysvar (readonly)
+ * Data: discriminator only (SeizeCollateralArgs is empty).
+ */
+declare function buildSeizeCollateralInstruction(p: SeizeCollateralParams): TransactionInstruction;
+interface MigrateV4ToV5Params {
+    vaultPda: PublicKey;
+    dexterAuthority: PublicKey;
+    payer: PublicKey;
+}
+/**
+ * Account order MUST match the on-chain struct:
+ *   [0] vault          (writable, AccountInfo validated in-handler)
+ *   [1] dexter_authority (signer)
+ *   [2] payer          (signer, writable)
+ *   [3] system_program (readonly)
+ * Data: discriminator only (MigrateV4ToV5Args is empty).
+ */
+declare function buildMigrateV4ToV5Instruction(p: MigrateV4ToV5Params): TransactionInstruction;
+
+export { type BuildRegisterSessionKeyArgs, type BuildRevokeSessionKeyArgs, type BuildSetSwigAtomicFromIdentityParams, type BuildSetSwigAtomicParams, type BuildSwigCreationBundleParams, type DrawCreditParams, type FinalizeWithdrawalParams, type ForceReleaseParams, type InitializeVaultParams, type LockVoucherParams, type MigrateV4ToV5Params, type OpenStandbyParams, type ProvePasskeyParams, type RecoverAbandonedLockParams, type RepayCreditParams, type RequestWithdrawalParams, type RotateDexterAuthorityParams, type RotatePasskeyParams, SET_SWIG_ATOMIC_DISCRIMINATOR, SWIG_PROGRAM_EXEC_MARKERS, SWIG_PROGRAM_EXEC_PREFIX, SWIG_PROGRAM_EXEC_PREFIX_SETTLE_TAB, type SeizeCollateralParams, type SetSwigParams, type SettleLockedVoucherParams, type SettleTabVoucherParams, type SettleVoucherParams, type SwigCreationBundleOutput, type SwigOwnershipCheck, type TransferLockOwnershipParams, buildDrawCreditInstruction, buildFinalizeWithdrawalInstruction, buildForceReleaseInstruction, buildInitializeVaultInstruction, buildLockVoucherInstruction, buildMigrateV4ToV5Instruction, buildOpenStandbyInstruction, buildProvePasskeyInstruction, buildRecoverAbandonedLockInstruction, buildRegisterSessionKeyInstruction, buildRepayCreditInstruction, buildRequestWithdrawalInstruction, buildRevokeSessionKeyInstruction, buildRotateDexterAuthorityInstruction, buildRotatePasskeyInstruction, buildSeizeCollateralInstruction, buildSetSwigAtomicFromIdentity, buildSetSwigAtomicInstruction, buildSetSwigInstruction, buildSettleLockedVoucherInstruction, buildSettleTabVoucherInstruction, buildSettleVoucherInstruction, buildSwigCreationBundle, buildTransferLockOwnershipInstruction, deriveLockedClaimPda, deriveSwigId, deriveSwigWalletAddress, deriveVaultPda, expectedSwigAddressFor, verifySwigIsOurs };

package/dist/instructions/index.d.ts

@@ -394,4 +394,175 @@ declare function deriveVaultPda(supabaseUserId: Uint8Array): {
     bump: number;
 };
 
-export { type BuildRegisterSessionKeyArgs, type BuildRevokeSessionKeyArgs, type BuildSetSwigAtomicFromIdentityParams, type BuildSetSwigAtomicParams, type BuildSwigCreationBundleParams, type FinalizeWithdrawalParams, type ForceReleaseParams, type InitializeVaultParams, type ProvePasskeyParams, type RequestWithdrawalParams, type RotateDexterAuthorityParams, type RotatePasskeyParams, SET_SWIG_ATOMIC_DISCRIMINATOR, SWIG_PROGRAM_EXEC_MARKERS, SWIG_PROGRAM_EXEC_PREFIX, SWIG_PROGRAM_EXEC_PREFIX_SETTLE_TAB, type SetSwigParams, type SettleTabVoucherParams, type SettleVoucherParams, type SwigCreationBundleOutput, type SwigOwnershipCheck, buildFinalizeWithdrawalInstruction, buildForceReleaseInstruction, buildInitializeVaultInstruction, buildProvePasskeyInstruction, buildRegisterSessionKeyInstruction, buildRequestWithdrawalInstruction, buildRevokeSessionKeyInstruction, buildRotateDexterAuthorityInstruction, buildRotatePasskeyInstruction, buildSetSwigAtomicFromIdentity, buildSetSwigAtomicInstruction, buildSetSwigInstruction, buildSettleTabVoucherInstruction, buildSettleVoucherInstruction, buildSwigCreationBundle, deriveSwigId, deriveSwigWalletAddress, deriveVaultPda, expectedSwigAddressFor, verifySwigIsOurs };
+/**
+ * LockedClaim instruction builders — the claim lifecycle.
+ * Mirrors the on-chain Anchor structs in
+ * programs/dexter-vault/src/instructions/{lock_voucher,settle_locked_voucher,
+ * transfer_lock_ownership,recover_abandoned_lock}.rs. Account ordering is
+ * consensus-critical and MUST match the program exactly.
+ */
+
+interface TransferLockOwnershipParams {
+    claimPda: PublicKey;
+    currentHolder: PublicKey;
+    newHolder: PublicKey;
+}
+/**
+ * Account order MUST match the on-chain struct:
+ *   [0] claim          (writable)
+ *   [1] current_holder (signer)
+ * Data: discriminator || new_holder (32-byte pubkey).
+ */
+declare function buildTransferLockOwnershipInstruction(p: TransferLockOwnershipParams): TransactionInstruction;
+interface SettleLockedVoucherParams {
+    swigAddress: PublicKey;
+    claimPda: PublicKey;
+    vaultPda: PublicKey;
+    holder: PublicKey;
+    dexterAuthority: PublicKey;
+}
+/**
+ * Account order MUST match the on-chain struct:
+ *   [0] swig                (readonly, == vault.swig_address)
+ *   [1] swig_wallet_address (readonly, PDA derived from swig)
+ *   [2] claim               (writable)
+ *   [3] vault               (writable)
+ *   [4] holder              (signer — the current claim holder collecting)
+ *   [5] dexter_authority    (signer)
+ * Data: discriminator only (SettleLockedVoucherArgs is empty).
+ */
+declare function buildSettleLockedVoucherInstruction(p: SettleLockedVoucherParams): TransactionInstruction;
+interface RecoverAbandonedLockParams {
+    claimPda: PublicKey;
+    vaultPda: PublicKey;
+    clientDataJSON: Uint8Array;
+    authenticatorData: Uint8Array;
+}
+/**
+ * Account order MUST match the on-chain struct:
+ *   [0] claim               (writable)
+ *   [1] vault               (writable)
+ *   [2] instructions_sysvar (readonly)
+ * Data: discriminator || vec(client_data_json) || vec(authenticator_data).
+ */
+declare function buildRecoverAbandonedLockInstruction(p: RecoverAbandonedLockParams): TransactionInstruction;
+/** LockedClaim PDA: [LOCKED_CLAIM_SEED, vault, voucher_hash] under the vault program. */
+declare function deriveLockedClaimPda(vaultPda: PublicKey, voucherHash: Uint8Array): PublicKey;
+interface LockVoucherParams {
+    vaultPda: PublicKey;
+    vaultUsdcAta: PublicKey;
+    swigAddress: PublicKey;
+    sellerHolder: PublicKey;
+    dexterAuthority: PublicKey;
+    payer: PublicKey;
+    channelId: Uint8Array;
+    cumulativeAmount: bigint;
+    sequenceNumber: number;
+    voucherHash: Uint8Array;
+    maturityAt: bigint | null;
+    holderRecoveryAt: bigint | null;
+}
+/**
+ * Account order MUST match the on-chain struct:
+ *   [0] vault               (writable)
+ *   [1] vault_usdc_ata      (readonly)
+ *   [2] swig                (readonly)
+ *   [3] swig_wallet_address (readonly, PDA)
+ *   [4] claim               (writable, PDA [LOCKED_CLAIM_SEED, vault, voucher_hash])
+ *   [5] seller_holder       (signer)
+ *   [6] dexter_authority    (signer)
+ *   [7] payer               (signer, writable)
+ *   [8] system_program      (readonly)
+ *   [9] instructions_sysvar (readonly)
+ * Data: disc || channel_id(32) || cumulative(u64) || sequence(u32)
+ *       || voucher_hash(32) || option_i64(maturity_at) || option_i64(holder_recovery_at)
+ */
+declare function buildLockVoucherInstruction(p: LockVoucherParams): TransactionInstruction;
+
+/**
+ * Credit-L2 instruction builders — the standby-credit lifecycle.
+ * Mirrors the on-chain Anchor structs in
+ * programs/dexter-vault/src/instructions/{open_standby,draw_credit,repay_credit,
+ * seize_collateral,migrate_v4_to_v5}.rs. Account ordering is consensus-critical
+ * and MUST match the program exactly.
+ */
+
+interface OpenStandbyParams {
+    vaultPda: PublicKey;
+    financierSwig: PublicKey;
+    cap: bigint;
+    clientDataJSON: Uint8Array;
+    authenticatorData: Uint8Array;
+}
+/**
+ * Account order MUST match the on-chain struct:
+ *   [0] vault               (writable)
+ *   [1] financier_swig      (readonly)
+ *   [2] instructions_sysvar (readonly)
+ * Data: disc || cap(u64) || vec(client_data_json) || vec(authenticator_data).
+ */
+declare function buildOpenStandbyInstruction(p: OpenStandbyParams): TransactionInstruction;
+interface DrawCreditParams {
+    financierSwig: PublicKey;
+    vaultPda: PublicKey;
+    dexterAuthority: PublicKey;
+    amount: bigint;
+    recoveryWindowSeconds: bigint;
+}
+/**
+ * Account order MUST match the on-chain struct:
+ *   [0] financier_swig                (readonly)
+ *   [1] financier_swig_wallet_address (readonly, PDA derived from financier_swig)
+ *   [2] vault                         (writable)
+ *   [3] dexter_authority              (signer)
+ *   [4] instructions_sysvar           (readonly)
+ * Data: disc || amount(u64) || recovery_window_seconds(i64).
+ */
+declare function buildDrawCreditInstruction(p: DrawCreditParams): TransactionInstruction;
+interface RepayCreditParams {
+    swigAddress: PublicKey;
+    vaultPda: PublicKey;
+    dexterAuthority: PublicKey;
+    amount: bigint;
+}
+/**
+ * Account order MUST match the on-chain struct:
+ *   [0] swig                (readonly, the USER's swig)
+ *   [1] swig_wallet_address (readonly, PDA derived from swig)
+ *   [2] vault               (writable)
+ *   [3] dexter_authority    (signer)
+ *   [4] instructions_sysvar (readonly)
+ * Data: disc || amount(u64).
+ */
+declare function buildRepayCreditInstruction(p: RepayCreditParams): TransactionInstruction;
+interface SeizeCollateralParams {
+    swigAddress: PublicKey;
+    vaultPda: PublicKey;
+    dexterAuthority: PublicKey;
+}
+/**
+ * Account order MUST match the on-chain struct:
+ *   [0] swig                (readonly, the USER's swig)
+ *   [1] swig_wallet_address (readonly, PDA derived from swig)
+ *   [2] vault               (writable)
+ *   [3] dexter_authority    (signer)
+ *   [4] instructions_sysvar (readonly)
+ * Data: discriminator only (SeizeCollateralArgs is empty).
+ */
+declare function buildSeizeCollateralInstruction(p: SeizeCollateralParams): TransactionInstruction;
+interface MigrateV4ToV5Params {
+    vaultPda: PublicKey;
+    dexterAuthority: PublicKey;
+    payer: PublicKey;
+}
+/**
+ * Account order MUST match the on-chain struct:
+ *   [0] vault          (writable, AccountInfo validated in-handler)
+ *   [1] dexter_authority (signer)
+ *   [2] payer          (signer, writable)
+ *   [3] system_program (readonly)
+ * Data: discriminator only (MigrateV4ToV5Args is empty).
+ */
+declare function buildMigrateV4ToV5Instruction(p: MigrateV4ToV5Params): TransactionInstruction;
+
+export { type BuildRegisterSessionKeyArgs, type BuildRevokeSessionKeyArgs, type BuildSetSwigAtomicFromIdentityParams, type BuildSetSwigAtomicParams, type BuildSwigCreationBundleParams, type DrawCreditParams, type FinalizeWithdrawalParams, type ForceReleaseParams, type InitializeVaultParams, type LockVoucherParams, type MigrateV4ToV5Params, type OpenStandbyParams, type ProvePasskeyParams, type RecoverAbandonedLockParams, type RepayCreditParams, type RequestWithdrawalParams, type RotateDexterAuthorityParams, type RotatePasskeyParams, SET_SWIG_ATOMIC_DISCRIMINATOR, SWIG_PROGRAM_EXEC_MARKERS, SWIG_PROGRAM_EXEC_PREFIX, SWIG_PROGRAM_EXEC_PREFIX_SETTLE_TAB, type SeizeCollateralParams, type SetSwigParams, type SettleLockedVoucherParams, type SettleTabVoucherParams, type SettleVoucherParams, type SwigCreationBundleOutput, type SwigOwnershipCheck, type TransferLockOwnershipParams, buildDrawCreditInstruction, buildFinalizeWithdrawalInstruction, buildForceReleaseInstruction, buildInitializeVaultInstruction, buildLockVoucherInstruction, buildMigrateV4ToV5Instruction, buildOpenStandbyInstruction, buildProvePasskeyInstruction, buildRecoverAbandonedLockInstruction, buildRegisterSessionKeyInstruction, buildRepayCreditInstruction, buildRequestWithdrawalInstruction, buildRevokeSessionKeyInstruction, buildRotateDexterAuthorityInstruction, buildRotatePasskeyInstruction, buildSeizeCollateralInstruction, buildSetSwigAtomicFromIdentity, buildSetSwigAtomicInstruction, buildSetSwigInstruction, buildSettleLockedVoucherInstruction, buildSettleTabVoucherInstruction, buildSettleVoucherInstruction, buildSwigCreationBundle, buildTransferLockOwnershipInstruction, deriveLockedClaimPda, deriveSwigId, deriveSwigWalletAddress, deriveVaultPda, expectedSwigAddressFor, verifySwigIsOurs };