@dexterai/vault 0.3.0 → 0.3.2

package/dist/instructions/index.d.cts

@@ -85,6 +85,38 @@ interface BuildSetSwigAtomicParams {
     authenticatorData: Uint8Array;
 }
 declare function buildSetSwigAtomicInstruction(params: BuildSetSwigAtomicParams): TransactionInstruction;
+interface BuildSetSwigAtomicFromIdentityParams {
+    /** dexter-vault PDA. */
+    vaultPda: PublicKey;
+    /** Outer-tx signer + role-0 bootstrap authority. */
+    feePayer: PublicKey;
+    /** Becomes role-2 (Ed25519Session) authority. */
+    dexterMasterPubkey: PublicKey;
+    /** Operator identity seed (e.g. 16-byte UUID). */
+    identitySeed: Uint8Array;
+    /**
+     * 32-byte HMAC key for swig_id derivation. MUST match the key
+     * buildSwigCreationBundle uses, or the derived swigId will not match
+     * the expected on-chain PDA.
+     */
+    hmacKey: Uint8Array;
+    /** WebAuthn ceremony outputs. */
+    clientDataJSON: Uint8Array;
+    authenticatorData: Uint8Array;
+}
+/**
+ * High-level convenience wrapper around buildSetSwigAtomicInstruction.
+ *
+ * Derives the 32-byte swigId via HMAC(identitySeed, hmacKey) using the
+ * SAME deriveSwigId helper as buildSwigCreationBundle, then finds the
+ * Swig state PDA and the Swig wallet PDA (with their bumps), then
+ * delegates to the low-level builder.
+ *
+ * Suitable for normal callers. Use the low-level builder directly only
+ * when you need to control swigId derivation yourself (e.g., byte-parity
+ * snapshot tests).
+ */
+declare function buildSetSwigAtomicFromIdentity(params: BuildSetSwigAtomicFromIdentityParams): TransactionInstruction;
 
 /**
  * register_session_key — authorize a session ed25519 key under a vault.
@@ -298,6 +330,15 @@ declare function buildProvePasskeyInstruction(p: ProvePasskeyParams): Transactio
 declare const SWIG_PROGRAM_EXEC_PREFIX: Uint8Array<ArrayBuffer>;
 declare const SWIG_PROGRAM_EXEC_PREFIX_SETTLE_TAB: Uint8Array<ArrayBuffer>;
 declare const SWIG_PROGRAM_EXEC_MARKERS: readonly Uint8Array[];
+/**
+ * HMAC-derive the 32-byte swigId used as the Swig state PDA seed.
+ *
+ * Exported so the high-level buildSetSwigAtomicFromIdentity wrapper in
+ * setSwigAtomic.ts can share the SAME derivation function — keeping a
+ * single source of truth and avoiding silent drift between the two
+ * paths that produce the same on-chain seed.
+ */
+declare function deriveSwigId(identitySeed: Uint8Array, hmacKey: Uint8Array): Buffer;
 interface BuildSwigCreationBundleParams {
     feePayer: string;
     dexterMasterPubkey: string;
@@ -335,4 +376,4 @@ declare function deriveVaultPda(supabaseUserId: Uint8Array): {
     bump: number;
 };
 
-export { type BuildRegisterSessionKeyArgs, type BuildRevokeSessionKeyArgs, 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, buildSetSwigAtomicInstruction, buildSetSwigInstruction, buildSettleTabVoucherInstruction, buildSettleVoucherInstruction, buildSwigCreationBundle, deriveSwigWalletAddress, deriveVaultPda, expectedSwigAddressFor, verifySwigIsOurs };
+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 };

package/dist/instructions/index.d.ts

@@ -85,6 +85,38 @@ interface BuildSetSwigAtomicParams {
     authenticatorData: Uint8Array;
 }
 declare function buildSetSwigAtomicInstruction(params: BuildSetSwigAtomicParams): TransactionInstruction;
+interface BuildSetSwigAtomicFromIdentityParams {
+    /** dexter-vault PDA. */
+    vaultPda: PublicKey;
+    /** Outer-tx signer + role-0 bootstrap authority. */
+    feePayer: PublicKey;
+    /** Becomes role-2 (Ed25519Session) authority. */
+    dexterMasterPubkey: PublicKey;
+    /** Operator identity seed (e.g. 16-byte UUID). */
+    identitySeed: Uint8Array;
+    /**
+     * 32-byte HMAC key for swig_id derivation. MUST match the key
+     * buildSwigCreationBundle uses, or the derived swigId will not match
+     * the expected on-chain PDA.
+     */
+    hmacKey: Uint8Array;
+    /** WebAuthn ceremony outputs. */
+    clientDataJSON: Uint8Array;
+    authenticatorData: Uint8Array;
+}
+/**
+ * High-level convenience wrapper around buildSetSwigAtomicInstruction.
+ *
+ * Derives the 32-byte swigId via HMAC(identitySeed, hmacKey) using the
+ * SAME deriveSwigId helper as buildSwigCreationBundle, then finds the
+ * Swig state PDA and the Swig wallet PDA (with their bumps), then
+ * delegates to the low-level builder.
+ *
+ * Suitable for normal callers. Use the low-level builder directly only
+ * when you need to control swigId derivation yourself (e.g., byte-parity
+ * snapshot tests).
+ */
+declare function buildSetSwigAtomicFromIdentity(params: BuildSetSwigAtomicFromIdentityParams): TransactionInstruction;
 
 /**
  * register_session_key — authorize a session ed25519 key under a vault.
@@ -298,6 +330,15 @@ declare function buildProvePasskeyInstruction(p: ProvePasskeyParams): Transactio
 declare const SWIG_PROGRAM_EXEC_PREFIX: Uint8Array<ArrayBuffer>;
 declare const SWIG_PROGRAM_EXEC_PREFIX_SETTLE_TAB: Uint8Array<ArrayBuffer>;
 declare const SWIG_PROGRAM_EXEC_MARKERS: readonly Uint8Array[];
+/**
+ * HMAC-derive the 32-byte swigId used as the Swig state PDA seed.
+ *
+ * Exported so the high-level buildSetSwigAtomicFromIdentity wrapper in
+ * setSwigAtomic.ts can share the SAME derivation function — keeping a
+ * single source of truth and avoiding silent drift between the two
+ * paths that produce the same on-chain seed.
+ */
+declare function deriveSwigId(identitySeed: Uint8Array, hmacKey: Uint8Array): Buffer;
 interface BuildSwigCreationBundleParams {
     feePayer: string;
     dexterMasterPubkey: string;
@@ -335,4 +376,4 @@ declare function deriveVaultPda(supabaseUserId: Uint8Array): {
     bump: number;
 };
 
-export { type BuildRegisterSessionKeyArgs, type BuildRevokeSessionKeyArgs, 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, buildSetSwigAtomicInstruction, buildSetSwigInstruction, buildSettleTabVoucherInstruction, buildSettleVoucherInstruction, buildSwigCreationBundle, deriveSwigWalletAddress, deriveVaultPda, expectedSwigAddressFor, verifySwigIsOurs };
+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 };