decane-connect-kit 2.4.0 → 2.5.0

package/dist/index.d.cts

@@ -185,6 +185,16 @@ declare class ApiClient {
         solanaAddress: string;
         tronAddress: string;
     }): Promise<void>;
+    recordTransaction(jwt: string, tx: {
+        chain: string;
+        txHash?: string;
+        to?: string;
+        value?: string;
+        kind?: string;
+        status?: string;
+        metadata?: Record<string, unknown>;
+    }): Promise<TransactionRecord>;
+    getTransactions(jwt: string, limit?: number): Promise<TransactionRecord[]>;
     getWebAuthnRegisterOptions(jwt: string, rpId: string, rpName: string): Promise<_simplewebauthn_browser.PublicKeyCredentialCreationOptionsJSON>;
     postWebAuthnRegister(jwt: string, response: _simplewebauthn_browser.RegistrationResponseJSON, origin: string): Promise<void>;
     /**
@@ -411,6 +421,29 @@ interface ConnectResult {
     };
     isNewUser: boolean;
 }
+/** A recorded on-chain transaction in the user's history. */
+interface TransactionRecord {
+    id: string;
+    chain: string;
+    kind: string;
+    txHash: string | null;
+    to: string | null;
+    value: string | null;
+    status: 'submitted' | 'confirmed' | 'failed' | string;
+    metadata: Record<string, unknown> | null;
+    createdAt: string;
+    updatedAt?: string;
+}
+/** What the dApp passes to record a transaction it broadcast. */
+interface RecordTransactionInput {
+    chain: string;
+    txHash?: string;
+    to?: string;
+    value?: string;
+    kind?: string;
+    status?: string;
+    metadata?: Record<string, unknown>;
+}
 interface SignMessageRequest {
     chain: Chain;
     message: string | Uint8Array;
@@ -521,6 +554,15 @@ interface DecaneConnect {
      * the transaction's `signature` array and broadcast via TronWeb / a full node.
      */
     signTronTransaction(rawDataHex: string): Promise<string>;
+    /**
+     * Record a transaction this wallet broadcast, so it appears in the user's
+     * history (and the developer dashboard). EVM `sendTransaction` records itself
+     * automatically; call this for Solana/Tron transactions your dApp broadcasts,
+     * or to attach a `confirmed`/`failed` status update to an existing hash.
+     */
+    recordTransaction(tx: RecordTransactionInput): Promise<TransactionRecord>;
+    /** The user's transaction history, most recent first. Requires a live session. */
+    getTransactionHistory(limit?: number): Promise<TransactionRecord[]>;
     disconnect(): Promise<void>;
     getAddresses(): {
         evm?: string;
@@ -933,6 +975,8 @@ declare function useSocialWallet(): {
     }) => Promise<string>;
     signSolanaTransaction: (tx: Uint8Array) => Promise<Uint8Array<ArrayBufferLike>>;
     signTronTransaction: (rawDataHex: string) => Promise<string>;
+    recordTransaction: (tx: RecordTransactionInput) => Promise<TransactionRecord>;
+    getTransactionHistory: (limit?: number) => Promise<TransactionRecord[]>;
     signTypedData: (req: {
         chain: string;
         domain: Record<string, unknown>;
@@ -1051,4 +1095,4 @@ declare function useSignTypedData(): {
     reset: () => void;
 };
 
-export { type ActiveSession, AttestationError, type AuthResult, BUILT_IN_CHAINS, type BalanceResult, type CAIP25Method, type CAIP25SessionRequest, type CAIP25SessionResult, CHAINS, CallSequenceError, type Chain, type ChainDescriptor, type ChainId, type ChainScope, type ChainSupport, type ChainType, type ConnectMode, type ConnectResult, type DecaneConfig, type DecaneConnect, type DecaneConnectConfig, DecaneConnectError, DecaneError, DecaneErrorCode, DecaneKit, DecaneLogo, DecaneMark, type DecaneProvider, DecaneWordmark, type Eip1193Provider, type EthereumProviderOptions, ExportNotAuthorizedError, InvalidApiKeyError, InvalidPinError, InvalidRecoveryFileError, NetworkError, NewDeviceError, OriginNotAllowedError, type PortableBackup, PromptPinNotConfiguredError, ReconnectRequiredError, RecoveryFailedError, type RecoveryProgress, type RecoveryShareFile, RecoveryWalletMismatchError, type SdkEvent, type SendTransactionRequest, SessionExpiredError, ShareCorruptedError, type SignMessageRequest, type SignTypedDataRequest, type SignedAuthorization, type SocialAuthState, type SocialConfig, SocialWalletModal, type Theme, type TxParams, type UnifiedWalletAccount, UnlockRequiredError, UserCancelledError, WalletSelector, WebAuthnNotSupportedError, type WrappedShareMeta, WrongPasswordError, createDecane, createDecaneConnect, createEthereumProvider, startEmailAuth, useChainSwitch, useDecane, useEthereumProvider, useSendTransaction, useSignMessage, useSignTypedData, useSocialAuth, useSocialBalance, useSocialWallet, useWalletSelector, verifyEmailCode };
+export { type ActiveSession, AttestationError, type AuthResult, BUILT_IN_CHAINS, type BalanceResult, type CAIP25Method, type CAIP25SessionRequest, type CAIP25SessionResult, CHAINS, CallSequenceError, type Chain, type ChainDescriptor, type ChainId, type ChainScope, type ChainSupport, type ChainType, type ConnectMode, type ConnectResult, type DecaneConfig, type DecaneConnect, type DecaneConnectConfig, DecaneConnectError, DecaneError, DecaneErrorCode, DecaneKit, DecaneLogo, DecaneMark, type DecaneProvider, DecaneWordmark, type Eip1193Provider, type EthereumProviderOptions, ExportNotAuthorizedError, InvalidApiKeyError, InvalidPinError, InvalidRecoveryFileError, NetworkError, NewDeviceError, OriginNotAllowedError, type PortableBackup, PromptPinNotConfiguredError, ReconnectRequiredError, type RecordTransactionInput, RecoveryFailedError, type RecoveryProgress, type RecoveryShareFile, RecoveryWalletMismatchError, type SdkEvent, type SendTransactionRequest, SessionExpiredError, ShareCorruptedError, type SignMessageRequest, type SignTypedDataRequest, type SignedAuthorization, type SocialAuthState, type SocialConfig, SocialWalletModal, type Theme, type TransactionRecord, type TxParams, type UnifiedWalletAccount, UnlockRequiredError, UserCancelledError, WalletSelector, WebAuthnNotSupportedError, type WrappedShareMeta, WrongPasswordError, createDecane, createDecaneConnect, createEthereumProvider, startEmailAuth, useChainSwitch, useDecane, useEthereumProvider, useSendTransaction, useSignMessage, useSignTypedData, useSocialAuth, useSocialBalance, useSocialWallet, useWalletSelector, verifyEmailCode };

package/dist/index.d.ts

@@ -185,6 +185,16 @@ declare class ApiClient {
         solanaAddress: string;
         tronAddress: string;
     }): Promise<void>;
+    recordTransaction(jwt: string, tx: {
+        chain: string;
+        txHash?: string;
+        to?: string;
+        value?: string;
+        kind?: string;
+        status?: string;
+        metadata?: Record<string, unknown>;
+    }): Promise<TransactionRecord>;
+    getTransactions(jwt: string, limit?: number): Promise<TransactionRecord[]>;
     getWebAuthnRegisterOptions(jwt: string, rpId: string, rpName: string): Promise<_simplewebauthn_browser.PublicKeyCredentialCreationOptionsJSON>;
     postWebAuthnRegister(jwt: string, response: _simplewebauthn_browser.RegistrationResponseJSON, origin: string): Promise<void>;
     /**
@@ -411,6 +421,29 @@ interface ConnectResult {
     };
     isNewUser: boolean;
 }
+/** A recorded on-chain transaction in the user's history. */
+interface TransactionRecord {
+    id: string;
+    chain: string;
+    kind: string;
+    txHash: string | null;
+    to: string | null;
+    value: string | null;
+    status: 'submitted' | 'confirmed' | 'failed' | string;
+    metadata: Record<string, unknown> | null;
+    createdAt: string;
+    updatedAt?: string;
+}
+/** What the dApp passes to record a transaction it broadcast. */
+interface RecordTransactionInput {
+    chain: string;
+    txHash?: string;
+    to?: string;
+    value?: string;
+    kind?: string;
+    status?: string;
+    metadata?: Record<string, unknown>;
+}
 interface SignMessageRequest {
     chain: Chain;
     message: string | Uint8Array;
@@ -521,6 +554,15 @@ interface DecaneConnect {
      * the transaction's `signature` array and broadcast via TronWeb / a full node.
      */
     signTronTransaction(rawDataHex: string): Promise<string>;
+    /**
+     * Record a transaction this wallet broadcast, so it appears in the user's
+     * history (and the developer dashboard). EVM `sendTransaction` records itself
+     * automatically; call this for Solana/Tron transactions your dApp broadcasts,
+     * or to attach a `confirmed`/`failed` status update to an existing hash.
+     */
+    recordTransaction(tx: RecordTransactionInput): Promise<TransactionRecord>;
+    /** The user's transaction history, most recent first. Requires a live session. */
+    getTransactionHistory(limit?: number): Promise<TransactionRecord[]>;
     disconnect(): Promise<void>;
     getAddresses(): {
         evm?: string;
@@ -933,6 +975,8 @@ declare function useSocialWallet(): {
     }) => Promise<string>;
     signSolanaTransaction: (tx: Uint8Array) => Promise<Uint8Array<ArrayBufferLike>>;
     signTronTransaction: (rawDataHex: string) => Promise<string>;
+    recordTransaction: (tx: RecordTransactionInput) => Promise<TransactionRecord>;
+    getTransactionHistory: (limit?: number) => Promise<TransactionRecord[]>;
     signTypedData: (req: {
         chain: string;
         domain: Record<string, unknown>;
@@ -1051,4 +1095,4 @@ declare function useSignTypedData(): {
     reset: () => void;
 };
 
-export { type ActiveSession, AttestationError, type AuthResult, BUILT_IN_CHAINS, type BalanceResult, type CAIP25Method, type CAIP25SessionRequest, type CAIP25SessionResult, CHAINS, CallSequenceError, type Chain, type ChainDescriptor, type ChainId, type ChainScope, type ChainSupport, type ChainType, type ConnectMode, type ConnectResult, type DecaneConfig, type DecaneConnect, type DecaneConnectConfig, DecaneConnectError, DecaneError, DecaneErrorCode, DecaneKit, DecaneLogo, DecaneMark, type DecaneProvider, DecaneWordmark, type Eip1193Provider, type EthereumProviderOptions, ExportNotAuthorizedError, InvalidApiKeyError, InvalidPinError, InvalidRecoveryFileError, NetworkError, NewDeviceError, OriginNotAllowedError, type PortableBackup, PromptPinNotConfiguredError, ReconnectRequiredError, RecoveryFailedError, type RecoveryProgress, type RecoveryShareFile, RecoveryWalletMismatchError, type SdkEvent, type SendTransactionRequest, SessionExpiredError, ShareCorruptedError, type SignMessageRequest, type SignTypedDataRequest, type SignedAuthorization, type SocialAuthState, type SocialConfig, SocialWalletModal, type Theme, type TxParams, type UnifiedWalletAccount, UnlockRequiredError, UserCancelledError, WalletSelector, WebAuthnNotSupportedError, type WrappedShareMeta, WrongPasswordError, createDecane, createDecaneConnect, createEthereumProvider, startEmailAuth, useChainSwitch, useDecane, useEthereumProvider, useSendTransaction, useSignMessage, useSignTypedData, useSocialAuth, useSocialBalance, useSocialWallet, useWalletSelector, verifyEmailCode };
+export { type ActiveSession, AttestationError, type AuthResult, BUILT_IN_CHAINS, type BalanceResult, type CAIP25Method, type CAIP25SessionRequest, type CAIP25SessionResult, CHAINS, CallSequenceError, type Chain, type ChainDescriptor, type ChainId, type ChainScope, type ChainSupport, type ChainType, type ConnectMode, type ConnectResult, type DecaneConfig, type DecaneConnect, type DecaneConnectConfig, DecaneConnectError, DecaneError, DecaneErrorCode, DecaneKit, DecaneLogo, DecaneMark, type DecaneProvider, DecaneWordmark, type Eip1193Provider, type EthereumProviderOptions, ExportNotAuthorizedError, InvalidApiKeyError, InvalidPinError, InvalidRecoveryFileError, NetworkError, NewDeviceError, OriginNotAllowedError, type PortableBackup, PromptPinNotConfiguredError, ReconnectRequiredError, type RecordTransactionInput, RecoveryFailedError, type RecoveryProgress, type RecoveryShareFile, RecoveryWalletMismatchError, type SdkEvent, type SendTransactionRequest, SessionExpiredError, ShareCorruptedError, type SignMessageRequest, type SignTypedDataRequest, type SignedAuthorization, type SocialAuthState, type SocialConfig, SocialWalletModal, type Theme, type TransactionRecord, type TxParams, type UnifiedWalletAccount, UnlockRequiredError, UserCancelledError, WalletSelector, WebAuthnNotSupportedError, type WrappedShareMeta, WrongPasswordError, createDecane, createDecaneConnect, createEthereumProvider, startEmailAuth, useChainSwitch, useDecane, useEthereumProvider, useSendTransaction, useSignMessage, useSignTypedData, useSocialAuth, useSocialBalance, useSocialWallet, useWalletSelector, verifyEmailCode };

package/dist/index.js

@@ -1991,6 +1991,21 @@ var ApiClient = class {
       })
     });
   }
+  // ── Transaction history ───────────────────────────────────────────────────
+  async recordTransaction(jwt, tx) {
+    const body = await this._request("/transactions", {
+      method: "POST",
+      headers: { Authorization: `Bearer ${jwt}` },
+      body: JSON.stringify(tx)
+    });
+    return body.transaction;
+  }
+  async getTransactions(jwt, limit = 50) {
+    const body = await this._request(`/transactions?limit=${encodeURIComponent(String(limit))}`, {
+      headers: { Authorization: `Bearer ${jwt}` }
+    });
+    return body.transactions;
+  }
   // ── WebAuthn registration (additive to the PRF-only passkey flow) ─────────
   async getWebAuthnRegisterOptions(jwt, rpId, rpName) {
     return this._request(`/webauthn/register-options?rpId=${encodeURIComponent(rpId)}&rpName=${encodeURIComponent(rpName)}`, {
@@ -3733,6 +3748,16 @@ async function createDecaneConnect(config) {
       };
       const signedTx = await signEvmTransaction(tee, req.chain, tx, auth?.jwt);
       const txResponse = await provider.broadcastTransaction(signedTx);
+      if (auth?.jwt) {
+        void api.recordTransaction(auth.jwt, {
+          chain: req.chain,
+          txHash: txResponse.hash,
+          to: req.to,
+          value: (req.value ?? 0n).toString(),
+          kind: "send"
+        }).catch(() => {
+        });
+      }
       return txResponse.hash;
     },
     async signTypedData(req) {
@@ -3765,6 +3790,14 @@ async function createDecaneConnect(config) {
     getAccessToken() {
       return auth?.jwt ?? null;
     },
+    async recordTransaction(tx) {
+      if (!auth?.jwt) throw new CallSequenceError("Not connected \u2014 call connect() first");
+      return api.recordTransaction(auth.jwt, tx);
+    },
+    async getTransactionHistory(limit = 50) {
+      if (!auth?.jwt) throw new CallSequenceError("Not connected \u2014 call connect() first");
+      return api.getTransactions(auth.jwt, limit);
+    },
     getEthereumProvider(opts) {
       if (!ethProvider) {
         const firstEvm = config.chains.find((c) => c.startsWith("evm:"));
@@ -5989,6 +6022,16 @@ function DecaneKit({ config, children }) {
     if (!sdk) throw new Error("Social wallet not connected");
     return sdk.signTronTransaction(rawDataHex);
   }, []);
+  const socialRecordTransaction = useCallback3(async (tx) => {
+    const sdk = socialRef.current;
+    if (!sdk) throw new Error("Social wallet not connected");
+    return sdk.recordTransaction(tx);
+  }, []);
+  const socialGetTransactionHistory = useCallback3(async (limit) => {
+    const sdk = socialRef.current;
+    if (!sdk) throw new Error("Social wallet not connected");
+    return sdk.getTransactionHistory(limit);
+  }, []);
   const socialSignTypedData = useCallback3(async (req) => {
     const sdk = socialRef.current;
     if (!sdk) throw new Error("Social wallet not connected");
@@ -6080,6 +6123,8 @@ function DecaneKit({ config, children }) {
         socialGetEthereumProvider,
         socialSignAuthorization,
         socialSignTronTransaction,
+        socialRecordTransaction,
+        socialGetTransactionHistory,
         socialGetAccessToken,
         socialSignSolanaTransaction,
         socialSignTypedData,
@@ -6301,6 +6346,8 @@ function useSocialWallet() {
     socialSendTransaction,
     socialSignSolanaTransaction,
     socialSignTronTransaction,
+    socialRecordTransaction,
+    socialGetTransactionHistory,
     socialSignTypedData,
     socialGetBalance,
     socialGetBalances,
@@ -6347,6 +6394,14 @@ function useSocialWallet() {
     (rawDataHex) => run(() => socialSignTronTransaction(rawDataHex)),
     [socialSignTronTransaction]
   );
+  const recordTransaction = useCallback4(
+    (tx) => run(() => socialRecordTransaction(tx)),
+    [socialRecordTransaction]
+  );
+  const getTransactionHistory = useCallback4(
+    (limit) => socialGetTransactionHistory(limit),
+    [socialGetTransactionHistory]
+  );
   const signTypedData = useCallback4(
     (req) => run(() => socialSignTypedData(req)),
     [socialSignTypedData]
@@ -6429,6 +6484,8 @@ function useSocialWallet() {
     sendTransaction,
     signSolanaTransaction: signSolanaTransaction2,
     signTronTransaction,
+    recordTransaction,
+    getTransactionHistory,
     signTypedData,
     // Balances (native token; read-only, works while locked)
     getBalance,