@chipi-stack/types 13.14.0 → 14.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024-2026 Chipi Pay
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,20 @@
 # @chipi-stack/types
 
-Utilities for Chipi SDKs
+TypeScript type definitions shared across all @chipi-stack packages.
+
+## Install
+
+```bash
+npm install @chipi-stack/types
+```
+
+## Key Exports
+
+- **Wallet**: WalletType, WalletData, CreateWalletParams, GetWalletResponse, DeploymentData
+- **Transaction**: Transaction, TxStatus, TxType, TransferParams, PrepareTypedDataParams
+- **SKU**: Sku, SkuCategory, GetSkuListQuery
+- **Core**: Chain, ChainToken, Currency, ChipiSDKConfig, PaginatedResponse
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -71,8 +71,9 @@ declare const STARKNET_CONTRACTS: Record<ChainToken, {
  * Supported wallet types
  * - CHIPI: OpenZeppelin account with SNIP-9 session keys support (default)
  * - READY: Argent X Account v0.4.0
+ * - Custom string values accepted for extensibility (e.g., community account implementations)
  */
-type WalletType = "CHIPI" | "READY";
+type WalletType = "CHIPI" | "READY" | (string & {});
 interface WalletData {
     publicKey: string;
     encryptedPrivateKey: string;
@@ -93,9 +94,15 @@ interface CreateWalletParams {
     /**
      * The type of wallet to create.
      * - "CHIPI" (default): OpenZeppelin account with SNIP-9 session keys support
-     * - "ARGENT": Argent X Account v0.4.0
+     * - "READY": Argent X Account v0.4.0
      */
     walletType?: WalletType;
+    /**
+     * Optional custom class hash for wallet deployment.
+     * When provided, overrides the default class hash for the wallet type.
+     * Use this for custom account implementations (e.g., community-submitted accounts).
+     */
+    classHash?: string;
     usePasskey?: boolean;
 }
 /**
@@ -170,6 +177,54 @@ interface PasskeyMetadata {
     userId: string;
     prfSupported: boolean;
 }
+/**
+ * Parameters for preparing a wallet upgrade (e.g., READY → CHIPI or CHIPI v29 → v33).
+ * Server-only: requires API secret key.
+ */
+interface PrepareWalletUpgradeParams {
+    /** Wallet address to upgrade */
+    walletAddress: string;
+    /** Target class hash to upgrade to (defaults to latest CHIPI if omitted) */
+    targetClassHash?: string;
+}
+/**
+ * Response from prepare-upgrade containing typed data for signing.
+ */
+interface PrepareWalletUpgradeResponse {
+    /** SNIP-12 typed data to sign for the upgrade */
+    typedData: TypedData;
+    /** Current class hash of the wallet */
+    currentClassHash: string;
+    /** Target class hash for upgrade */
+    targetClassHash: string;
+    /** Current wallet type */
+    currentWalletType: WalletType;
+    /** Target wallet type after upgrade */
+    targetWalletType: WalletType;
+}
+/**
+ * Parameters for executing a wallet upgrade after signing.
+ * Server-only: requires API secret key.
+ */
+interface ExecuteWalletUpgradeParams {
+    /** Wallet address being upgraded */
+    walletAddress: string;
+    /** SNIP-12 typed data (from prepare step) */
+    typedData: TypedData;
+    /** User signature over the typed data */
+    signature: string[];
+}
+/**
+ * Response from wallet upgrade execution.
+ */
+interface ExecuteWalletUpgradeResponse {
+    /** Transaction hash for the upgrade */
+    transactionHash: string;
+    /** New class hash after upgrade */
+    newClassHash: string;
+    /** New wallet type after upgrade */
+    newWalletType: WalletType;
+}
 
 /**
  * Transaction-related types
@@ -190,7 +245,6 @@ type ExecuteTransactionParams = PasskeyParams & {
 };
 type TxType = string;
 type TxStatus = "PENDING" | "PROCESSING" | "SUCCESS" | "FAILED" | "CANCELLED";
-type SkuStatus = "PENDING" | "PROCESSING" | "SUCCESS" | "FAILED" | "CANCELLED";
 interface Transaction {
     id: string;
     type: TxType;
@@ -203,7 +257,7 @@ interface Transaction {
     contractName?: string;
     functionName?: string;
     functionSelector?: string;
-    callData?: Record<string, unknown>;
+    callData?: unknown;
     token?: ChainToken;
     tokenAddress?: string;
     amount?: string;
@@ -215,7 +269,6 @@ interface Transaction {
     skuPurchaseAmount?: number;
     skuPurchaseCurrency?: Currency;
     skuFileNumber?: string;
-    skuStatus?: SkuStatus;
     status: TxStatus;
     createdAt: Date;
     confirmedAt?: Date;
@@ -307,6 +360,88 @@ interface GetTransactionListQuery {
     month?: number;
     year?: number;
 }
+/**
+ * Parameters for fetching a single transaction by hash or internal ID.
+ */
+interface GetTransactionParams {
+    /** Transaction hash (0x...) or internal database ID */
+    hashOrId: string;
+}
+/**
+ * Parameters for fetching on-chain transaction status.
+ */
+interface GetTransactionStatusParams {
+    /** Transaction hash (0x...) */
+    hash: string;
+}
+/**
+ * On-chain transaction status from StarkNet sequencer.
+ */
+declare enum OnChainTxStatus {
+    RECEIVED = "RECEIVED",
+    PENDING = "PENDING",
+    ACCEPTED_ON_L2 = "ACCEPTED_ON_L2",
+    ACCEPTED_ON_L1 = "ACCEPTED_ON_L1",
+    REJECTED = "REJECTED",
+    REVERTED = "REVERTED",
+    NOT_RECEIVED = "NOT_RECEIVED"
+}
+/**
+ * Response from the transaction status endpoint.
+ */
+interface TransactionStatusResponse {
+    /** Transaction hash */
+    transactionHash: string;
+    /** Current on-chain status */
+    status: OnChainTxStatus;
+    /** Block number (if included in a block) */
+    blockNumber?: number;
+    /** Revert reason (if status is REVERTED) */
+    revertReason?: string;
+}
+/**
+ * Minimal account interface for PaymasterAdapter.
+ * Compatible with starknet.js Account, external wallet objects, and Cartridge Controller.
+ */
+interface PaymasterAccount {
+    address: string;
+    signMessage(typedData: TypedData): Promise<unknown>;
+    getClassHashAt(contractAddress: string): Promise<string>;
+}
+/**
+ * Adapter for executing gasless (paymaster-sponsored) transactions.
+ *
+ * Handles the full flow: prepare typed data -> sign -> submit to paymaster.
+ * For external wallets (Argent X, Braavos), `account.signMessage()` triggers the wallet popup.
+ * For DirectSigner, signing happens programmatically.
+ */
+interface PaymasterAdapter {
+    execute(params: {
+        account: PaymasterAccount;
+        calls: Call[];
+    }): Promise<string>;
+}
+/**
+ * Parameters for signing SNIP-12 typed data without executing a transaction.
+ * Useful for x402 payment signatures and other off-chain signing flows.
+ */
+interface SignTypedDataParams {
+    /** Encryption key (PIN) to decrypt the private key */
+    encryptKey: string;
+    /** Wallet data containing encrypted private key */
+    wallet: WalletData;
+    /** SNIP-12 typed data to sign */
+    typedData: TypedData;
+}
+/**
+ * Result of signing SNIP-12 typed data.
+ */
+interface SignTypedDataResult {
+    /** Signature r component */
+    r: string;
+    /** Signature s component */
+    s: string;
+}
 
 /**
  * SKU Purchase types
@@ -360,7 +495,7 @@ interface WithdrawVesuUsdcHookInputParams {
     usePasskey?: boolean;
 }
 
-type SkuCategory = 'TELEPEAJE' | 'TELEFONIA' | 'GENERAL' | 'TESORERIA' | 'LUZ' | 'INTERNET' | 'TV' | 'MOVILIDAD' | 'RECARGAS' | 'GIFT_CARDS' | 'GAMING' | 'VENTAS_CATALOGO' | 'DEPORTES' | 'STREAMING';
+type SkuCategory = "TELEPEAJE" | "TELEFONIA" | "GENERAL" | "TESORERIA" | "LUZ" | "INTERNET" | "TV" | "MOVILIDAD" | "RECARGAS" | "GIFT_CARDS" | "GAMING" | "VENTAS_CATALOGO" | "DEPORTES" | "STREAMING";
 interface Sku {
     id: string;
     providerId: string;
@@ -372,6 +507,7 @@ interface Sku {
     amountRegexValidation: string;
     amountLabel: string;
     fixedAmount?: number;
+    currency: Currency;
     canCheckSkuReference: boolean;
     logoUrl?: string;
     createdAt: Date;
@@ -389,7 +525,7 @@ interface ApiKey {
     id: string;
     publicKey: string;
     secretKey: string;
-    environment: 'development' | 'production';
+    environment: "development" | "production";
     isActive: boolean;
     orgId: string;
     createdAt: Date;
@@ -621,4 +757,118 @@ interface SessionWalletData extends WalletData {
     walletType: WalletType;
 }
 
-export { type AddSessionKeyParams, type ApiError, type ApiKey, type ApiResponse, type ApproveHookInput, type ApproveParams, type AsyncReturnType, type AuthContext, type CallAnyContractParams, Chain, ChainToken, type ChipiBrowserSDKConfig, type ChipiSDKConfig, type ChipiServerSDKConfig, type Country, type CreateCustodialWalletParams, type CreateSessionKeyParams, type CreateSkuPurchaseBody, type CreateSkuPurchaseParams, type CreateUserParams, type CreateWalletParams, type CreateWalletResponse, Currency, type DeepPartial, type DeploymentData, type ErrorWithCode, type ExecuteSponsoredTransactionParams, type ExecuteSponsoredTransactionResponse, type ExecuteTransactionParams, type ExecuteWithSessionParams, type GetMerchantWalletParams, type GetSessionDataParams, type GetSkuListQuery, type GetTokenBalanceParams, type GetTokenBalanceResponse, type GetTransactionListQuery, type GetTransactionsParams, type GetUserParams, type GetWalletParams, type GetWalletResponse, type JwtPayload, type MaybePromise, type MigrateWalletToPasskeyParams, type NonEmptyArray, type Optional, type PaginatedResponse, type PaginationQuery, type PasskeyMetadata, type PrepareTypedDataParams, type PrepareTypedDataResponse, type PrepareWalletCreationParams, type PrepareWalletCreationResponse, type Prettify, type RecordSendTransactionParams, type RequireAtLeastOne, type RevokeSessionKeyParams, STARKNET_CONTRACTS, type SessionConfig, type SessionDataResponse, type SessionKeyData, type SessionWalletData, type Sku, type SkuCategory, type SkuStatus, type StakeVesuUsdcHookInputParams, type StakeVesuUsdcParams, type Transaction, type TransferHookInput, type TransferParams, type TxStatus, type TxType, type UpdateWalletEncryptionParams, type UpdateWalletEncryptionResponse, type User, type ValueOrFunction, type WalletData, type WalletType, type WithdrawVesuUsdcHookInputParams, type WithdrawVesuUsdcParams, type alphaUrl };
+/**
+ * x402 Payment Protocol types for HTTP 402 pay-per-request APIs.
+ *
+ * Implements the x402 open payment protocol (https://www.x402.org/) for Starknet,
+ * using SNIP-12 typed data signing and paymaster-sponsored USDC transfers.
+ */
+/** Payment requirement returned in 402 response PAYMENT-REQUIRED header */
+interface PaymentRequirement {
+    /** Payment scheme — x402-starknet uses "exact" */
+    scheme: "exact";
+    /** Network identifier */
+    network: "starknet-mainnet";
+    /** Amount in token base units (e.g. "10000" = 0.01 USDC) */
+    maxAmountRequired: string;
+    /** URL of the resource being paid for */
+    resource: string;
+    /** Human-readable description of the payment */
+    description?: string;
+    /** MIME type of the resource */
+    mimeType?: string;
+    /** Recipient address (merchant) */
+    payTo: string;
+    /** Max seconds before payment expires */
+    maxTimeoutSeconds: number;
+    /** Token contract address (USDC) */
+    asset: string;
+    /** Additional protocol-specific data */
+    extra?: Record<string, unknown>;
+}
+/** Signed payment payload sent in X-PAYMENT header */
+interface PaymentPayload {
+    x402Version: 1;
+    scheme: "exact";
+    network: "starknet-mainnet";
+    payload: {
+        signature: {
+            r: string;
+            s: string;
+        };
+        fromAddress: string;
+        toAddress: string;
+        amount: string;
+        asset: string;
+        validUntil: number;
+        nonce: string;
+    };
+}
+/** Facilitator verify response */
+interface VerifyResponse {
+    isValid: boolean;
+    invalidReason?: string;
+}
+/** Facilitator settle response */
+interface SettleResponse {
+    success: boolean;
+    transactionHash?: string;
+    errorReason?: string;
+    networkId?: string;
+}
+/**
+ * Pluggable nonce store for facilitator replay protection.
+ * Default: in-memory Set (resets on restart).
+ * For production: plug in Redis, PostgreSQL, DynamoDB, etc.
+ */
+interface NonceStore {
+    /** Check if nonce has been used (non-consuming read). */
+    has(nonce: string): Promise<boolean> | boolean;
+    /**
+     * Atomically consume a nonce. Returns true if successfully consumed (was new).
+     * Returns false if nonce was already used.
+     * Must be atomic to prevent concurrent replay attacks.
+     * Maps to Redis SETNX, PostgreSQL INSERT ON CONFLICT DO NOTHING, etc.
+     */
+    consume(nonce: string): Promise<boolean> | boolean;
+}
+/** x402 client configuration */
+interface X402ClientConfig {
+    /** Max amount willing to pay per request (in human-readable units, e.g. "1.00" = 1 USDC) */
+    maxPaymentAmount?: string;
+    /** Allowed recipient addresses (whitelist). Empty = allow all. */
+    allowedRecipients?: string[];
+    /** Custom header name (default: "X-PAYMENT") */
+    headerName?: string;
+}
+/** x402 facilitator configuration */
+interface X402FacilitatorConfig {
+    /** Custom nonce store for persistent replay protection. Defaults to in-memory. */
+    nonceStore?: NonceStore;
+    /**
+     * RPC provider for on-chain SNIP-12 signature verification.
+     * When provided, the facilitator calls `is_valid_signature()` on the sender's
+     * account contract to cryptographically verify the payment signature.
+     * When omitted, falls back to presence-only signature check (backwards compatible).
+     *
+     * Accepts any object with a `callContract` method (e.g. starknet.js RpcProvider).
+     */
+    provider?: {
+        callContract(call: {
+            contractAddress: string;
+            entrypoint: string;
+            calldata?: string[];
+        }): Promise<string[]>;
+    };
+}
+/** x402 middleware payment config for a protected endpoint */
+interface X402PaymentConfig {
+    /** Amount in human-readable units (e.g. "0.01" for 0.01 USDC) */
+    amount: string;
+    /** Merchant receiving address */
+    payTo: string;
+    /** Human-readable description */
+    description?: string;
+}
+
+export { type AddSessionKeyParams, type ApiError, type ApiKey, type ApiResponse, type ApproveHookInput, type ApproveParams, type AsyncReturnType, type AuthContext, type CallAnyContractParams, Chain, ChainToken, type ChipiBrowserSDKConfig, type ChipiSDKConfig, type ChipiServerSDKConfig, type Country, type CreateCustodialWalletParams, type CreateSessionKeyParams, type CreateSkuPurchaseBody, type CreateSkuPurchaseParams, type CreateUserParams, type CreateWalletParams, type CreateWalletResponse, Currency, type DeepPartial, type DeploymentData, type ErrorWithCode, type ExecuteSponsoredTransactionParams, type ExecuteSponsoredTransactionResponse, type ExecuteTransactionParams, type ExecuteWalletUpgradeParams, type ExecuteWalletUpgradeResponse, type ExecuteWithSessionParams, type GetMerchantWalletParams, type GetSessionDataParams, type GetSkuListQuery, type GetTokenBalanceParams, type GetTokenBalanceResponse, type GetTransactionListQuery, type GetTransactionParams, type GetTransactionStatusParams, type GetTransactionsParams, type GetUserParams, type GetWalletParams, type GetWalletResponse, type JwtPayload, type MaybePromise, type MigrateWalletToPasskeyParams, type NonEmptyArray, type NonceStore, OnChainTxStatus, type Optional, type PaginatedResponse, type PaginationQuery, type PasskeyMetadata, type PaymasterAccount, type PaymasterAdapter, type PaymentPayload, type PaymentRequirement, type PrepareTypedDataParams, type PrepareTypedDataResponse, type PrepareWalletCreationParams, type PrepareWalletCreationResponse, type PrepareWalletUpgradeParams, type PrepareWalletUpgradeResponse, type Prettify, type RecordSendTransactionParams, type RequireAtLeastOne, type RevokeSessionKeyParams, STARKNET_CONTRACTS, type SessionConfig, type SessionDataResponse, type SessionKeyData, type SessionWalletData, type SettleResponse, type SignTypedDataParams, type SignTypedDataResult, type Sku, type SkuCategory, type StakeVesuUsdcHookInputParams, type StakeVesuUsdcParams, type Transaction, type TransactionStatusResponse, type TransferHookInput, type TransferParams, type TxStatus, type TxType, type UpdateWalletEncryptionParams, type UpdateWalletEncryptionResponse, type User, type ValueOrFunction, type VerifyResponse, type WalletData, type WalletType, type WithdrawVesuUsdcHookInputParams, type WithdrawVesuUsdcParams, type X402ClientConfig, type X402FacilitatorConfig, type X402PaymentConfig, type alphaUrl };

package/dist/index.d.ts

@@ -71,8 +71,9 @@ declare const STARKNET_CONTRACTS: Record<ChainToken, {
  * Supported wallet types
  * - CHIPI: OpenZeppelin account with SNIP-9 session keys support (default)
  * - READY: Argent X Account v0.4.0
+ * - Custom string values accepted for extensibility (e.g., community account implementations)
  */
-type WalletType = "CHIPI" | "READY";
+type WalletType = "CHIPI" | "READY" | (string & {});
 interface WalletData {
     publicKey: string;
     encryptedPrivateKey: string;
@@ -93,9 +94,15 @@ interface CreateWalletParams {
     /**
      * The type of wallet to create.
      * - "CHIPI" (default): OpenZeppelin account with SNIP-9 session keys support
-     * - "ARGENT": Argent X Account v0.4.0
+     * - "READY": Argent X Account v0.4.0
      */
     walletType?: WalletType;
+    /**
+     * Optional custom class hash for wallet deployment.
+     * When provided, overrides the default class hash for the wallet type.
+     * Use this for custom account implementations (e.g., community-submitted accounts).
+     */
+    classHash?: string;
     usePasskey?: boolean;
 }
 /**
@@ -170,6 +177,54 @@ interface PasskeyMetadata {
     userId: string;
     prfSupported: boolean;
 }
+/**
+ * Parameters for preparing a wallet upgrade (e.g., READY → CHIPI or CHIPI v29 → v33).
+ * Server-only: requires API secret key.
+ */
+interface PrepareWalletUpgradeParams {
+    /** Wallet address to upgrade */
+    walletAddress: string;
+    /** Target class hash to upgrade to (defaults to latest CHIPI if omitted) */
+    targetClassHash?: string;
+}
+/**
+ * Response from prepare-upgrade containing typed data for signing.
+ */
+interface PrepareWalletUpgradeResponse {
+    /** SNIP-12 typed data to sign for the upgrade */
+    typedData: TypedData;
+    /** Current class hash of the wallet */
+    currentClassHash: string;
+    /** Target class hash for upgrade */
+    targetClassHash: string;
+    /** Current wallet type */
+    currentWalletType: WalletType;
+    /** Target wallet type after upgrade */
+    targetWalletType: WalletType;
+}
+/**
+ * Parameters for executing a wallet upgrade after signing.
+ * Server-only: requires API secret key.
+ */
+interface ExecuteWalletUpgradeParams {
+    /** Wallet address being upgraded */
+    walletAddress: string;
+    /** SNIP-12 typed data (from prepare step) */
+    typedData: TypedData;
+    /** User signature over the typed data */
+    signature: string[];
+}
+/**
+ * Response from wallet upgrade execution.
+ */
+interface ExecuteWalletUpgradeResponse {
+    /** Transaction hash for the upgrade */
+    transactionHash: string;
+    /** New class hash after upgrade */
+    newClassHash: string;
+    /** New wallet type after upgrade */
+    newWalletType: WalletType;
+}
 
 /**
  * Transaction-related types
@@ -190,7 +245,6 @@ type ExecuteTransactionParams = PasskeyParams & {
 };
 type TxType = string;
 type TxStatus = "PENDING" | "PROCESSING" | "SUCCESS" | "FAILED" | "CANCELLED";
-type SkuStatus = "PENDING" | "PROCESSING" | "SUCCESS" | "FAILED" | "CANCELLED";
 interface Transaction {
     id: string;
     type: TxType;
@@ -203,7 +257,7 @@ interface Transaction {
     contractName?: string;
     functionName?: string;
     functionSelector?: string;
-    callData?: Record<string, unknown>;
+    callData?: unknown;
     token?: ChainToken;
     tokenAddress?: string;
     amount?: string;
@@ -215,7 +269,6 @@ interface Transaction {
     skuPurchaseAmount?: number;
     skuPurchaseCurrency?: Currency;
     skuFileNumber?: string;
-    skuStatus?: SkuStatus;
     status: TxStatus;
     createdAt: Date;
     confirmedAt?: Date;
@@ -307,6 +360,88 @@ interface GetTransactionListQuery {
     month?: number;
     year?: number;
 }
+/**
+ * Parameters for fetching a single transaction by hash or internal ID.
+ */
+interface GetTransactionParams {
+    /** Transaction hash (0x...) or internal database ID */
+    hashOrId: string;
+}
+/**
+ * Parameters for fetching on-chain transaction status.
+ */
+interface GetTransactionStatusParams {
+    /** Transaction hash (0x...) */
+    hash: string;
+}
+/**
+ * On-chain transaction status from StarkNet sequencer.
+ */
+declare enum OnChainTxStatus {
+    RECEIVED = "RECEIVED",
+    PENDING = "PENDING",
+    ACCEPTED_ON_L2 = "ACCEPTED_ON_L2",
+    ACCEPTED_ON_L1 = "ACCEPTED_ON_L1",
+    REJECTED = "REJECTED",
+    REVERTED = "REVERTED",
+    NOT_RECEIVED = "NOT_RECEIVED"
+}
+/**
+ * Response from the transaction status endpoint.
+ */
+interface TransactionStatusResponse {
+    /** Transaction hash */
+    transactionHash: string;
+    /** Current on-chain status */
+    status: OnChainTxStatus;
+    /** Block number (if included in a block) */
+    blockNumber?: number;
+    /** Revert reason (if status is REVERTED) */
+    revertReason?: string;
+}
+/**
+ * Minimal account interface for PaymasterAdapter.
+ * Compatible with starknet.js Account, external wallet objects, and Cartridge Controller.
+ */
+interface PaymasterAccount {
+    address: string;
+    signMessage(typedData: TypedData): Promise<unknown>;
+    getClassHashAt(contractAddress: string): Promise<string>;
+}
+/**
+ * Adapter for executing gasless (paymaster-sponsored) transactions.
+ *
+ * Handles the full flow: prepare typed data -> sign -> submit to paymaster.
+ * For external wallets (Argent X, Braavos), `account.signMessage()` triggers the wallet popup.
+ * For DirectSigner, signing happens programmatically.
+ */
+interface PaymasterAdapter {
+    execute(params: {
+        account: PaymasterAccount;
+        calls: Call[];
+    }): Promise<string>;
+}
+/**
+ * Parameters for signing SNIP-12 typed data without executing a transaction.
+ * Useful for x402 payment signatures and other off-chain signing flows.
+ */
+interface SignTypedDataParams {
+    /** Encryption key (PIN) to decrypt the private key */
+    encryptKey: string;
+    /** Wallet data containing encrypted private key */
+    wallet: WalletData;
+    /** SNIP-12 typed data to sign */
+    typedData: TypedData;
+}
+/**
+ * Result of signing SNIP-12 typed data.
+ */
+interface SignTypedDataResult {
+    /** Signature r component */
+    r: string;
+    /** Signature s component */
+    s: string;
+}
 
 /**
  * SKU Purchase types
@@ -360,7 +495,7 @@ interface WithdrawVesuUsdcHookInputParams {
     usePasskey?: boolean;
 }
 
-type SkuCategory = 'TELEPEAJE' | 'TELEFONIA' | 'GENERAL' | 'TESORERIA' | 'LUZ' | 'INTERNET' | 'TV' | 'MOVILIDAD' | 'RECARGAS' | 'GIFT_CARDS' | 'GAMING' | 'VENTAS_CATALOGO' | 'DEPORTES' | 'STREAMING';
+type SkuCategory = "TELEPEAJE" | "TELEFONIA" | "GENERAL" | "TESORERIA" | "LUZ" | "INTERNET" | "TV" | "MOVILIDAD" | "RECARGAS" | "GIFT_CARDS" | "GAMING" | "VENTAS_CATALOGO" | "DEPORTES" | "STREAMING";
 interface Sku {
     id: string;
     providerId: string;
@@ -372,6 +507,7 @@ interface Sku {
     amountRegexValidation: string;
     amountLabel: string;
     fixedAmount?: number;
+    currency: Currency;
     canCheckSkuReference: boolean;
     logoUrl?: string;
     createdAt: Date;
@@ -389,7 +525,7 @@ interface ApiKey {
     id: string;
     publicKey: string;
     secretKey: string;
-    environment: 'development' | 'production';
+    environment: "development" | "production";
     isActive: boolean;
     orgId: string;
     createdAt: Date;
@@ -621,4 +757,118 @@ interface SessionWalletData extends WalletData {
     walletType: WalletType;
 }
 
-export { type AddSessionKeyParams, type ApiError, type ApiKey, type ApiResponse, type ApproveHookInput, type ApproveParams, type AsyncReturnType, type AuthContext, type CallAnyContractParams, Chain, ChainToken, type ChipiBrowserSDKConfig, type ChipiSDKConfig, type ChipiServerSDKConfig, type Country, type CreateCustodialWalletParams, type CreateSessionKeyParams, type CreateSkuPurchaseBody, type CreateSkuPurchaseParams, type CreateUserParams, type CreateWalletParams, type CreateWalletResponse, Currency, type DeepPartial, type DeploymentData, type ErrorWithCode, type ExecuteSponsoredTransactionParams, type ExecuteSponsoredTransactionResponse, type ExecuteTransactionParams, type ExecuteWithSessionParams, type GetMerchantWalletParams, type GetSessionDataParams, type GetSkuListQuery, type GetTokenBalanceParams, type GetTokenBalanceResponse, type GetTransactionListQuery, type GetTransactionsParams, type GetUserParams, type GetWalletParams, type GetWalletResponse, type JwtPayload, type MaybePromise, type MigrateWalletToPasskeyParams, type NonEmptyArray, type Optional, type PaginatedResponse, type PaginationQuery, type PasskeyMetadata, type PrepareTypedDataParams, type PrepareTypedDataResponse, type PrepareWalletCreationParams, type PrepareWalletCreationResponse, type Prettify, type RecordSendTransactionParams, type RequireAtLeastOne, type RevokeSessionKeyParams, STARKNET_CONTRACTS, type SessionConfig, type SessionDataResponse, type SessionKeyData, type SessionWalletData, type Sku, type SkuCategory, type SkuStatus, type StakeVesuUsdcHookInputParams, type StakeVesuUsdcParams, type Transaction, type TransferHookInput, type TransferParams, type TxStatus, type TxType, type UpdateWalletEncryptionParams, type UpdateWalletEncryptionResponse, type User, type ValueOrFunction, type WalletData, type WalletType, type WithdrawVesuUsdcHookInputParams, type WithdrawVesuUsdcParams, type alphaUrl };
+/**
+ * x402 Payment Protocol types for HTTP 402 pay-per-request APIs.
+ *
+ * Implements the x402 open payment protocol (https://www.x402.org/) for Starknet,
+ * using SNIP-12 typed data signing and paymaster-sponsored USDC transfers.
+ */
+/** Payment requirement returned in 402 response PAYMENT-REQUIRED header */
+interface PaymentRequirement {
+    /** Payment scheme — x402-starknet uses "exact" */
+    scheme: "exact";
+    /** Network identifier */
+    network: "starknet-mainnet";
+    /** Amount in token base units (e.g. "10000" = 0.01 USDC) */
+    maxAmountRequired: string;
+    /** URL of the resource being paid for */
+    resource: string;
+    /** Human-readable description of the payment */
+    description?: string;
+    /** MIME type of the resource */
+    mimeType?: string;
+    /** Recipient address (merchant) */
+    payTo: string;
+    /** Max seconds before payment expires */
+    maxTimeoutSeconds: number;
+    /** Token contract address (USDC) */
+    asset: string;
+    /** Additional protocol-specific data */
+    extra?: Record<string, unknown>;
+}
+/** Signed payment payload sent in X-PAYMENT header */
+interface PaymentPayload {
+    x402Version: 1;
+    scheme: "exact";
+    network: "starknet-mainnet";
+    payload: {
+        signature: {
+            r: string;
+            s: string;
+        };
+        fromAddress: string;
+        toAddress: string;
+        amount: string;
+        asset: string;
+        validUntil: number;
+        nonce: string;
+    };
+}
+/** Facilitator verify response */
+interface VerifyResponse {
+    isValid: boolean;
+    invalidReason?: string;
+}
+/** Facilitator settle response */
+interface SettleResponse {
+    success: boolean;
+    transactionHash?: string;
+    errorReason?: string;
+    networkId?: string;
+}
+/**
+ * Pluggable nonce store for facilitator replay protection.
+ * Default: in-memory Set (resets on restart).
+ * For production: plug in Redis, PostgreSQL, DynamoDB, etc.
+ */
+interface NonceStore {
+    /** Check if nonce has been used (non-consuming read). */
+    has(nonce: string): Promise<boolean> | boolean;
+    /**
+     * Atomically consume a nonce. Returns true if successfully consumed (was new).
+     * Returns false if nonce was already used.
+     * Must be atomic to prevent concurrent replay attacks.
+     * Maps to Redis SETNX, PostgreSQL INSERT ON CONFLICT DO NOTHING, etc.
+     */
+    consume(nonce: string): Promise<boolean> | boolean;
+}
+/** x402 client configuration */
+interface X402ClientConfig {
+    /** Max amount willing to pay per request (in human-readable units, e.g. "1.00" = 1 USDC) */
+    maxPaymentAmount?: string;
+    /** Allowed recipient addresses (whitelist). Empty = allow all. */
+    allowedRecipients?: string[];
+    /** Custom header name (default: "X-PAYMENT") */
+    headerName?: string;
+}
+/** x402 facilitator configuration */
+interface X402FacilitatorConfig {
+    /** Custom nonce store for persistent replay protection. Defaults to in-memory. */
+    nonceStore?: NonceStore;
+    /**
+     * RPC provider for on-chain SNIP-12 signature verification.
+     * When provided, the facilitator calls `is_valid_signature()` on the sender's
+     * account contract to cryptographically verify the payment signature.
+     * When omitted, falls back to presence-only signature check (backwards compatible).
+     *
+     * Accepts any object with a `callContract` method (e.g. starknet.js RpcProvider).
+     */
+    provider?: {
+        callContract(call: {
+            contractAddress: string;
+            entrypoint: string;
+            calldata?: string[];
+        }): Promise<string[]>;
+    };
+}
+/** x402 middleware payment config for a protected endpoint */
+interface X402PaymentConfig {
+    /** Amount in human-readable units (e.g. "0.01" for 0.01 USDC) */
+    amount: string;
+    /** Merchant receiving address */
+    payTo: string;
+    /** Human-readable description */
+    description?: string;
+}
+
+export { type AddSessionKeyParams, type ApiError, type ApiKey, type ApiResponse, type ApproveHookInput, type ApproveParams, type AsyncReturnType, type AuthContext, type CallAnyContractParams, Chain, ChainToken, type ChipiBrowserSDKConfig, type ChipiSDKConfig, type ChipiServerSDKConfig, type Country, type CreateCustodialWalletParams, type CreateSessionKeyParams, type CreateSkuPurchaseBody, type CreateSkuPurchaseParams, type CreateUserParams, type CreateWalletParams, type CreateWalletResponse, Currency, type DeepPartial, type DeploymentData, type ErrorWithCode, type ExecuteSponsoredTransactionParams, type ExecuteSponsoredTransactionResponse, type ExecuteTransactionParams, type ExecuteWalletUpgradeParams, type ExecuteWalletUpgradeResponse, type ExecuteWithSessionParams, type GetMerchantWalletParams, type GetSessionDataParams, type GetSkuListQuery, type GetTokenBalanceParams, type GetTokenBalanceResponse, type GetTransactionListQuery, type GetTransactionParams, type GetTransactionStatusParams, type GetTransactionsParams, type GetUserParams, type GetWalletParams, type GetWalletResponse, type JwtPayload, type MaybePromise, type MigrateWalletToPasskeyParams, type NonEmptyArray, type NonceStore, OnChainTxStatus, type Optional, type PaginatedResponse, type PaginationQuery, type PasskeyMetadata, type PaymasterAccount, type PaymasterAdapter, type PaymentPayload, type PaymentRequirement, type PrepareTypedDataParams, type PrepareTypedDataResponse, type PrepareWalletCreationParams, type PrepareWalletCreationResponse, type PrepareWalletUpgradeParams, type PrepareWalletUpgradeResponse, type Prettify, type RecordSendTransactionParams, type RequireAtLeastOne, type RevokeSessionKeyParams, STARKNET_CONTRACTS, type SessionConfig, type SessionDataResponse, type SessionKeyData, type SessionWalletData, type SettleResponse, type SignTypedDataParams, type SignTypedDataResult, type Sku, type SkuCategory, type StakeVesuUsdcHookInputParams, type StakeVesuUsdcParams, type Transaction, type TransactionStatusResponse, type TransferHookInput, type TransferParams, type TxStatus, type TxType, type UpdateWalletEncryptionParams, type UpdateWalletEncryptionResponse, type User, type ValueOrFunction, type VerifyResponse, type WalletData, type WalletType, type WithdrawVesuUsdcHookInputParams, type WithdrawVesuUsdcParams, type X402ClientConfig, type X402FacilitatorConfig, type X402PaymentConfig, type alphaUrl };

package/dist/index.js

@@ -97,9 +97,22 @@ var STARKNET_CONTRACTS = {
   }
 };
 
+// src/transaction.ts
+var OnChainTxStatus = /* @__PURE__ */ ((OnChainTxStatus2) => {
+  OnChainTxStatus2["RECEIVED"] = "RECEIVED";
+  OnChainTxStatus2["PENDING"] = "PENDING";
+  OnChainTxStatus2["ACCEPTED_ON_L2"] = "ACCEPTED_ON_L2";
+  OnChainTxStatus2["ACCEPTED_ON_L1"] = "ACCEPTED_ON_L1";
+  OnChainTxStatus2["REJECTED"] = "REJECTED";
+  OnChainTxStatus2["REVERTED"] = "REVERTED";
+  OnChainTxStatus2["NOT_RECEIVED"] = "NOT_RECEIVED";
+  return OnChainTxStatus2;
+})(OnChainTxStatus || {});
+
 exports.Chain = Chain;
 exports.ChainToken = ChainToken;
 exports.Currency = Currency;
+exports.OnChainTxStatus = OnChainTxStatus;
 exports.STARKNET_CONTRACTS = STARKNET_CONTRACTS;
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/core.ts"],"names":["Chain","Currency","ChainToken"],"mappings":";;;AAsBO,IAAK,KAAA,qBAAAA,MAAAA,KAAL;AACL,EAAAA,OAAA,UAAA,CAAA,GAAW,UAAA;AACX,EAAAA,OAAA,MAAA,CAAA,GAAO,MAAA;AACP,EAAAA,OAAA,UAAA,CAAA,GAAW,UAAA;AACX,EAAAA,OAAA,UAAA,CAAA,GAAW,UAAA;AACX,EAAAA,OAAA,WAAA,CAAA,GAAY,WAAA;AACZ,EAAAA,OAAA,QAAA,CAAA,GAAS,QAAA;AACT,EAAAA,OAAA,YAAA,CAAA,GAAa,YAAA;AAPH,EAAA,OAAAA,MAAAA;AAAA,CAAA,EAAA,KAAA,IAAA,EAAA;AAUL,IAAK,QAAA,qBAAAC,SAAAA,KAAL;AACL,EAAAA,UAAA,KAAA,CAAA,GAAM,KAAA;AACN,EAAAA,UAAA,KAAA,CAAA,GAAM,KAAA;AAFI,EAAA,OAAAA,SAAAA;AAAA,CAAA,EAAA,QAAA,IAAA,EAAA;AAKL,IAAK,UAAA,qBAAAC,WAAAA,KAAL;AACL,EAAAA,YAAA,MAAA,CAAA,GAAO,MAAA;AACP,EAAAA,YAAA,QAAA,CAAA,GAAS,QAAA;AACT,EAAAA,YAAA,MAAA,CAAA,GAAO,MAAA;AACP,EAAAA,YAAA,KAAA,CAAA,GAAM,KAAA;AACN,EAAAA,YAAA,KAAA,CAAA,GAAM,KAAA;AACN,EAAAA,YAAA,MAAA,CAAA,GAAO,MAAA;AACP,EAAAA,YAAA,OAAA,CAAA,GAAQ,OAAA;AACR,EAAAA,YAAA,KAAA,CAAA,GAAM,KAAA;AACN,EAAAA,YAAA,SAAA,CAAA,GAAU,SAAA;AACV,EAAAA,YAAA,KAAA,CAAA,GAAM,KAAA;AACN,EAAAA,YAAA,KAAA,CAAA,GAAM,KAAA;AACN,EAAAA,YAAA,MAAA,CAAA,GAAO,MAAA;AACP,EAAAA,YAAA,KAAA,CAAA,GAAM,KAAA;AACN,EAAAA,YAAA,MAAA,CAAA,GAAO,MAAA;AACP,EAAAA,YAAA,OAAA,CAAA,GAAQ,OAAA;AAfE,EAAA,OAAAA,WAAAA;AAAA,CAAA,EAAA,UAAA,IAAA,EAAA;AAgCL,IAAM,kBAAA,GAGT;AAAA,EACF,CAAC,oBAAkB;AAAA,IACjB,eAAA,EACE,oEAAA;AAAA,IACF,QAAA,EAAU;AAAA,GACZ;AAAA,EACA,CAAC,wBAAoB;AAAA,IACnB,eAAA,EACE,oEAAA;AAAA,IACF,QAAA,EAAU;AAAA,GACZ;AAAA,EACA,CAAC,oBAAkB;AAAA,IACjB,eAAA,EACE,oEAAA;AAAA,IACF,QAAA,EAAU;AAAA,GACZ;AAAA,EACA,CAAC,kBAAiB;AAAA,IAChB,eAAA,EACE,oEAAA;AAAA,IACF,QAAA,EAAU;AAAA,GACZ;AAAA,EACA,CAAC,oBAAkB;AAAA,IACjB,eAAA,EACE,oEAAA;AAAA,IACF,QAAA,EAAU;AAAA,GACZ;AAAA,EACA,CAAC,kBAAiB;AAAA,IAChB,eAAA,EACE,oEAAA;AAAA,IACF,QAAA,EAAU;AAAA,GACZ;AAAA,EACA,CAAC,oBAAkB;AAAA,IACjB,eAAA,EACE,oEAAA;AAAA,IACF,QAAA,EAAU;AAAA,GACZ;AAAA,EACA,CAAC,sBAAmB;AAAA,IAClB,eAAA,EAAiB,EAAA;AAAA,IACjB,QAAA,EAAU;AAAA,GACZ;AAAA,EACA,CAAC,kBAAiB;AAAA,IAChB,eAAA,EAAiB,EAAA;AAAA,IACjB,QAAA,EAAU;AAAA,GACZ;AAAA,EACA,CAAC,0BAAqB;AAAA,IACpB,eAAA,EAAiB,EAAA;AAAA,IACjB,QAAA,EAAU;AAAA,GACZ;AAAA,EACA,CAAC,kBAAiB;AAAA,IAChB,eAAA,EAAiB,EAAA;AAAA,IACjB,QAAA,EAAU;AAAA,GACZ;AAAA,EACA,CAAC,kBAAiB;AAAA,IAChB,eAAA,EAAiB,EAAA;AAAA,IACjB,QAAA,EAAU;AAAA,GACZ;AAAA,EACA,CAAC,oBAAkB;AAAA,IACjB,eAAA,EAAiB,EAAA;AAAA,IACjB,QAAA,EAAU;AAAA,GACZ;AAAA,EACA,CAAC,kBAAiB;AAAA,IAChB,eAAA,EAAiB,EAAA;AAAA,IACjB,QAAA,EAAU;AAAA,GACZ;AAAA,EACA,CAAC,sBAAmB;AAAA,IAClB,eAAA,EAAiB,EAAA;AAAA,IACjB,QAAA,EAAU;AAAA;AAEd","file":"index.js","sourcesContent":["/**\n * Core configuration and environment types\n */\n\nexport interface ChipiSDKConfig {\n  apiPublicKey: string;\n  alphaUrl?: string;\n  nodeUrl?: string;\n  apiSecretKey?: string;\n}\n\nexport interface ChipiServerSDKConfig extends ChipiSDKConfig {\n  apiSecretKey: string;\n}\n\nexport interface ChipiBrowserSDKConfig\n  extends Omit<ChipiSDKConfig, \"apiSecretKey\"> {\n  apiSecretKey?: never;\n}\n\nexport type alphaUrl = string;\n\nexport enum Chain {\n  STARKNET = \"STARKNET\",\n  BASE = \"BASE\",\n  ARBITRUM = \"ARBITRUM\",\n  OPTIMISM = \"OPTIMISM\",\n  ROOTSTOCK = \"ROOTSTOCK\",\n  SCROLL = \"SCROLL\",\n  WORLDCHAIN = \"WORLDCHAIN\",\n}\n\nexport enum Currency {\n  MXN = \"MXN\",\n  USD = \"USD\",\n}\n\nexport enum ChainToken {\n  USDC = \"USDC\",\n  USDC_E = \"USDC_E\",\n  USDT = \"USDT\",\n  DAI = \"DAI\",\n  ETH = \"ETH\",\n  STRK = \"STRK\",\n  SLINK = \"SLINK\",\n  ALF = \"ALF\",\n  BROTHER = \"BROTHER\",\n  ARB = \"ARB\",\n  DOC = \"DOC\",\n  MXNB = \"MXNB\",\n  WLD = \"WLD\",\n  WBTC = \"WBTC\",\n  OTHER = \"OTHER\",\n}\n\nexport interface PaginationQuery {\n  page?: number;\n  limit?: number;\n  offset?: number;\n}\n\nexport interface PaginatedResponse<T> {\n  data: T[];\n  total: number;\n  page: number;\n  limit: number;\n  totalPages: number;\n}\n\nexport const STARKNET_CONTRACTS: Record<\n  ChainToken,\n  { contractAddress: string; decimals: number }\n> = {\n  [ChainToken.USDC]: {\n    contractAddress:\n      \"0x033068F6539f8e6e6b131e6B2B814e6c34A5224bC66947c47DaB9dFeE93b35fb\",\n    decimals: 6,\n  },\n  [ChainToken.USDC_E]: {\n    contractAddress:\n      \"0x053c91253bc9682c04929ca02ed00b3e423f6710d2ee7e0d5ebb06f3ecf368a8\",\n    decimals: 6,\n  },\n  [ChainToken.USDT]: {\n    contractAddress:\n      \"0x068f5c6a61780768455de69077e07e89787839bf8166decfbf92b645209c0fb8\",\n    decimals: 6,\n  },\n  [ChainToken.DAI]: {\n    contractAddress:\n      \"0x05574eb6b8789a91466f902c380d978e472db68170ff82a5b650b95a58ddf4ad\",\n    decimals: 18,\n  },\n  [ChainToken.STRK]: {\n    contractAddress:\n      \"0x04718f5a0fc34cc1af16a1cdee98ffb20c31f5cd61d6ab07201858f4287c938d\",\n    decimals: 18,\n  },\n  [ChainToken.ETH]: {\n    contractAddress:\n      \"0x049d36570d4e46f48e99674bd3fcc84644ddd6b96f7c741b1562b82f9e004dc7\",\n    decimals: 18,\n  },\n  [ChainToken.WBTC]: {\n    contractAddress:\n      \"0x03fe2b97c1fd336e750087d68b9b867997fd64a2661ff3ca5a7c771641e8e7ac\",\n    decimals: 8,\n  },\n  [ChainToken.SLINK]: {\n    contractAddress: \"\",\n    decimals: 18,\n  },\n  [ChainToken.ALF]: {\n    contractAddress: \"\",\n    decimals: 18,\n  },\n  [ChainToken.BROTHER]: {\n    contractAddress: \"\",\n    decimals: 18,\n  },\n  [ChainToken.ARB]: {\n    contractAddress: \"\",\n    decimals: 18,\n  },\n  [ChainToken.DOC]: {\n    contractAddress: \"\",\n    decimals: 18,\n  },\n  [ChainToken.MXNB]: {\n    contractAddress: \"\",\n    decimals: 18,\n  },\n  [ChainToken.WLD]: {\n    contractAddress: \"\",\n    decimals: 18,\n  },\n  [ChainToken.OTHER]: {\n    contractAddress: \"\",\n    decimals: 18,\n  },\n};\n"]}
+{"version":3,"sources":["../src/core.ts","../src/transaction.ts"],"names":["Chain","Currency","ChainToken","OnChainTxStatus"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Core configuration and environment types\n */\n\nexport interface ChipiSDKConfig {\n  apiPublicKey: string;\n  alphaUrl?: string;\n  nodeUrl?: string;\n  apiSecretKey?: string;\n}\n\nexport interface ChipiServerSDKConfig extends ChipiSDKConfig {\n  apiSecretKey: string;\n}\n\nexport interface ChipiBrowserSDKConfig extends Omit<ChipiSDKConfig, \"apiSecretKey\"> {\n  apiSecretKey?: never;\n}\n\nexport type alphaUrl = string;\n\nexport enum Chain {\n  STARKNET = \"STARKNET\",\n  BASE = \"BASE\",\n  ARBITRUM = \"ARBITRUM\",\n  OPTIMISM = \"OPTIMISM\",\n  ROOTSTOCK = \"ROOTSTOCK\",\n  SCROLL = \"SCROLL\",\n  WORLDCHAIN = \"WORLDCHAIN\",\n}\n\nexport enum Currency {\n  MXN = \"MXN\",\n  USD = \"USD\",\n}\n\nexport enum ChainToken {\n  USDC = \"USDC\",\n  USDC_E = \"USDC_E\",\n  USDT = \"USDT\",\n  DAI = \"DAI\",\n  ETH = \"ETH\",\n  STRK = \"STRK\",\n  SLINK = \"SLINK\",\n  ALF = \"ALF\",\n  BROTHER = \"BROTHER\",\n  ARB = \"ARB\",\n  DOC = \"DOC\",\n  MXNB = \"MXNB\",\n  WLD = \"WLD\",\n  WBTC = \"WBTC\",\n  OTHER = \"OTHER\",\n}\n\nexport interface PaginationQuery {\n  page?: number;\n  limit?: number;\n  offset?: number;\n}\n\nexport interface PaginatedResponse<T> {\n  data: T[];\n  total: number;\n  page: number;\n  limit: number;\n  totalPages: number;\n}\n\nexport const STARKNET_CONTRACTS: Record<ChainToken, { contractAddress: string; decimals: number }> =\n  {\n    [ChainToken.USDC]: {\n      contractAddress: \"0x033068F6539f8e6e6b131e6B2B814e6c34A5224bC66947c47DaB9dFeE93b35fb\",\n      decimals: 6,\n    },\n    [ChainToken.USDC_E]: {\n      contractAddress: \"0x053c91253bc9682c04929ca02ed00b3e423f6710d2ee7e0d5ebb06f3ecf368a8\",\n      decimals: 6,\n    },\n    [ChainToken.USDT]: {\n      contractAddress: \"0x068f5c6a61780768455de69077e07e89787839bf8166decfbf92b645209c0fb8\",\n      decimals: 6,\n    },\n    [ChainToken.DAI]: {\n      contractAddress: \"0x05574eb6b8789a91466f902c380d978e472db68170ff82a5b650b95a58ddf4ad\",\n      decimals: 18,\n    },\n    [ChainToken.STRK]: {\n      contractAddress: \"0x04718f5a0fc34cc1af16a1cdee98ffb20c31f5cd61d6ab07201858f4287c938d\",\n      decimals: 18,\n    },\n    [ChainToken.ETH]: {\n      contractAddress: \"0x049d36570d4e46f48e99674bd3fcc84644ddd6b96f7c741b1562b82f9e004dc7\",\n      decimals: 18,\n    },\n    [ChainToken.WBTC]: {\n      contractAddress: \"0x03fe2b97c1fd336e750087d68b9b867997fd64a2661ff3ca5a7c771641e8e7ac\",\n      decimals: 8,\n    },\n    [ChainToken.SLINK]: {\n      contractAddress: \"\",\n      decimals: 18,\n    },\n    [ChainToken.ALF]: {\n      contractAddress: \"\",\n      decimals: 18,\n    },\n    [ChainToken.BROTHER]: {\n      contractAddress: \"\",\n      decimals: 18,\n    },\n    [ChainToken.ARB]: {\n      contractAddress: \"\",\n      decimals: 18,\n    },\n    [ChainToken.DOC]: {\n      contractAddress: \"\",\n      decimals: 18,\n    },\n    [ChainToken.MXNB]: {\n      contractAddress: \"\",\n      decimals: 18,\n    },\n    [ChainToken.WLD]: {\n      contractAddress: \"\",\n      decimals: 18,\n    },\n    [ChainToken.OTHER]: {\n      contractAddress: \"\",\n      decimals: 18,\n    },\n  };\n","import type { Call, TypedData } from \"starknet\";\nimport type { WalletData, WalletType } from \"./wallet\";\nimport { Chain, ChainToken, Currency } from \"./core\";\n\n/**\n * Transaction-related types\n */\n\ntype PasskeyEnabledParams = {\n  usePasskey: true;\n  externalUserId: string;\n};\n\ntype PasskeyDisabledParams = {\n  usePasskey?: false;\n  externalUserId?: string;\n};\n\ntype PasskeyParams = PasskeyEnabledParams | PasskeyDisabledParams;\n\nexport type ExecuteTransactionParams = PasskeyParams & {\n  encryptKey?: string;\n  wallet: WalletData;\n  calls: Call[];\n};\n\nexport type TxType = string;\nexport type TxStatus = \"PENDING\" | \"PROCESSING\" | \"SUCCESS\" | \"FAILED\" | \"CANCELLED\";\n\nexport interface Transaction {\n  id: string;\n  type: TxType;\n  subType?: string;\n  chain: Chain;\n  transactionHash: string;\n\n  // Parties\n  senderAddress: string;\n  destinationAddress: string;\n\n  // Contract Interaction\n  contractAddress?: string;\n  contractName?: string;\n  functionName?: string;\n  functionSelector?: string;\n  callData?: unknown;\n\n  // Token Transfer (nullable for non-token operations)\n  token?: ChainToken;\n  tokenAddress?: string;\n  amount?: string;\n\n  // NFT Specific\n  nftTokenId?: string;\n  nftContract?: string;\n  nftMetadata?: Record<string, unknown>;\n\n  // SKU Specific\n  skuId?: string;\n  skuReference?: string;\n  skuPurchaseAmount?: number;\n  skuPurchaseCurrency?: Currency;\n  skuFileNumber?: string;\n\n  // Status\n  status: TxStatus;\n\n  // Timestamps\n  createdAt: Date;\n  confirmedAt?: Date;\n  updatedAt: Date;\n\n  // Relations\n  apiPublicKey: string;\n  chipiWalletId?: string;\n  destinationChipiWalletId?: string;\n}\n\nexport interface PrepareTypedDataParams {\n  calls: Call[];\n  walletAddress: string;\n}\n\nexport interface PrepareTypedDataResponse {\n  typedData: TypedData;\n  walletType: WalletType;\n}\n\nexport interface ExecuteSponsoredTransactionParams {\n  calls: Call[];\n  walletAddress: string;\n  signature: string[];\n  apiPublicKey: string;\n}\n\nexport interface ExecuteSponsoredTransactionResponse {\n  transactionHash: string;\n}\n\nexport interface RecordSendTransactionParams {\n  transactionHash: string;\n  expectedSender: string;\n  expectedRecipient: string;\n  expectedToken: ChainToken;\n  expectedAmount: string;\n  chain: Chain;\n}\n\n// Specific transaction types\nexport type TransferParams = PasskeyParams & {\n  encryptKey?: string;\n  wallet: WalletData;\n  token: ChainToken;\n  otherToken?: {\n    contractAddress: string;\n    decimals: number;\n  };\n  recipient: string;\n  amount: string;\n};\n\nexport type TransferHookInput = PasskeyParams & {\n  encryptKey?: string;\n  wallet: WalletData;\n  token: ChainToken;\n  otherToken?: {\n    contractAddress: string;\n    decimals: number;\n  };\n  recipient: string;\n  amount: number;\n};\n\nexport type ApproveParams = PasskeyParams & {\n  encryptKey?: string;\n  wallet: WalletData;\n  contractAddress: string;\n  spender: string;\n  amount: string;\n  decimals?: number;\n};\n\nexport type ApproveHookInput = PasskeyParams & {\n  encryptKey?: string;\n  wallet: WalletData;\n  contractAddress: string;\n  spender: string;\n  decimals?: number;\n  amount: number;\n};\n\nexport type CallAnyContractParams = PasskeyParams & {\n  encryptKey?: string;\n  wallet: WalletData;\n  contractAddress: string;\n  calls: Call[];\n};\n\nexport interface GetTransactionsParams {\n  page?: number;\n  limit?: number;\n  orgId: string;\n}\n\nexport interface GetTransactionListQuery {\n  page?: number;\n  limit?: number;\n  calledFunction?: string;\n  walletAddress: string; // Required: wallet address to filter transactions\n  day?: number; // Day of the month (1-31)\n  month?: number; // Month of the year (1-12)\n  year?: number; // Year (e.g., 2025)\n}\n\n/**\n * Parameters for fetching a single transaction by hash or internal ID.\n */\nexport interface GetTransactionParams {\n  /** Transaction hash (0x...) or internal database ID */\n  hashOrId: string;\n}\n\n/**\n * Parameters for fetching on-chain transaction status.\n */\nexport interface GetTransactionStatusParams {\n  /** Transaction hash (0x...) */\n  hash: string;\n}\n\n/**\n * On-chain transaction status from StarkNet sequencer.\n */\nexport enum OnChainTxStatus {\n  RECEIVED = \"RECEIVED\",\n  PENDING = \"PENDING\",\n  ACCEPTED_ON_L2 = \"ACCEPTED_ON_L2\",\n  ACCEPTED_ON_L1 = \"ACCEPTED_ON_L1\",\n  REJECTED = \"REJECTED\",\n  REVERTED = \"REVERTED\",\n  NOT_RECEIVED = \"NOT_RECEIVED\",\n}\n\n/**\n * Response from the transaction status endpoint.\n */\nexport interface TransactionStatusResponse {\n  /** Transaction hash */\n  transactionHash: string;\n  /** Current on-chain status */\n  status: OnChainTxStatus;\n  /** Block number (if included in a block) */\n  blockNumber?: number;\n  /** Revert reason (if status is REVERTED) */\n  revertReason?: string;\n}\n\n/**\n * Minimal account interface for PaymasterAdapter.\n * Compatible with starknet.js Account, external wallet objects, and Cartridge Controller.\n */\nexport interface PaymasterAccount {\n  address: string;\n  signMessage(typedData: TypedData): Promise<unknown>;\n  getClassHashAt(contractAddress: string): Promise<string>;\n}\n\n/**\n * Adapter for executing gasless (paymaster-sponsored) transactions.\n *\n * Handles the full flow: prepare typed data -> sign -> submit to paymaster.\n * For external wallets (Argent X, Braavos), `account.signMessage()` triggers the wallet popup.\n * For DirectSigner, signing happens programmatically.\n */\nexport interface PaymasterAdapter {\n  execute(params: { account: PaymasterAccount; calls: Call[] }): Promise<string>;\n}\n\n/**\n * Parameters for signing SNIP-12 typed data without executing a transaction.\n * Useful for x402 payment signatures and other off-chain signing flows.\n */\nexport interface SignTypedDataParams {\n  /** Encryption key (PIN) to decrypt the private key */\n  encryptKey: string;\n  /** Wallet data containing encrypted private key */\n  wallet: WalletData;\n  /** SNIP-12 typed data to sign */\n  typedData: TypedData;\n}\n\n/**\n * Result of signing SNIP-12 typed data.\n */\nexport interface SignTypedDataResult {\n  /** Signature r component */\n  r: string;\n  /** Signature s component */\n  s: string;\n}\n"]}

package/dist/index.mjs

@@ -95,6 +95,18 @@ var STARKNET_CONTRACTS = {
   }
 };
 
-export { Chain, ChainToken, Currency, STARKNET_CONTRACTS };
+// src/transaction.ts
+var OnChainTxStatus = /* @__PURE__ */ ((OnChainTxStatus2) => {
+  OnChainTxStatus2["RECEIVED"] = "RECEIVED";
+  OnChainTxStatus2["PENDING"] = "PENDING";
+  OnChainTxStatus2["ACCEPTED_ON_L2"] = "ACCEPTED_ON_L2";
+  OnChainTxStatus2["ACCEPTED_ON_L1"] = "ACCEPTED_ON_L1";
+  OnChainTxStatus2["REJECTED"] = "REJECTED";
+  OnChainTxStatus2["REVERTED"] = "REVERTED";
+  OnChainTxStatus2["NOT_RECEIVED"] = "NOT_RECEIVED";
+  return OnChainTxStatus2;
+})(OnChainTxStatus || {});
+
+export { Chain, ChainToken, Currency, OnChainTxStatus, STARKNET_CONTRACTS };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/core.ts"],"names":["Chain","Currency","ChainToken"],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * Core configuration and environment types\n */\n\nexport interface ChipiSDKConfig {\n  apiPublicKey: string;\n  alphaUrl?: string;\n  nodeUrl?: string;\n  apiSecretKey?: string;\n}\n\nexport interface ChipiServerSDKConfig extends ChipiSDKConfig {\n  apiSecretKey: string;\n}\n\nexport interface ChipiBrowserSDKConfig\n  extends Omit<ChipiSDKConfig, \"apiSecretKey\"> {\n  apiSecretKey?: never;\n}\n\nexport type alphaUrl = string;\n\nexport enum Chain {\n  STARKNET = \"STARKNET\",\n  BASE = \"BASE\",\n  ARBITRUM = \"ARBITRUM\",\n  OPTIMISM = \"OPTIMISM\",\n  ROOTSTOCK = \"ROOTSTOCK\",\n  SCROLL = \"SCROLL\",\n  WORLDCHAIN = \"WORLDCHAIN\",\n}\n\nexport enum Currency {\n  MXN = \"MXN\",\n  USD = \"USD\",\n}\n\nexport enum ChainToken {\n  USDC = \"USDC\",\n  USDC_E = \"USDC_E\",\n  USDT = \"USDT\",\n  DAI = \"DAI\",\n  ETH = \"ETH\",\n  STRK = \"STRK\",\n  SLINK = \"SLINK\",\n  ALF = \"ALF\",\n  BROTHER = \"BROTHER\",\n  ARB = \"ARB\",\n  DOC = \"DOC\",\n  MXNB = \"MXNB\",\n  WLD = \"WLD\",\n  WBTC = \"WBTC\",\n  OTHER = \"OTHER\",\n}\n\nexport interface PaginationQuery {\n  page?: number;\n  limit?: number;\n  offset?: number;\n}\n\nexport interface PaginatedResponse<T> {\n  data: T[];\n  total: number;\n  page: number;\n  limit: number;\n  totalPages: number;\n}\n\nexport const STARKNET_CONTRACTS: Record<\n  ChainToken,\n  { contractAddress: string; decimals: number }\n> = {\n  [ChainToken.USDC]: {\n    contractAddress:\n      \"0x033068F6539f8e6e6b131e6B2B814e6c34A5224bC66947c47DaB9dFeE93b35fb\",\n    decimals: 6,\n  },\n  [ChainToken.USDC_E]: {\n    contractAddress:\n      \"0x053c91253bc9682c04929ca02ed00b3e423f6710d2ee7e0d5ebb06f3ecf368a8\",\n    decimals: 6,\n  },\n  [ChainToken.USDT]: {\n    contractAddress:\n      \"0x068f5c6a61780768455de69077e07e89787839bf8166decfbf92b645209c0fb8\",\n    decimals: 6,\n  },\n  [ChainToken.DAI]: {\n    contractAddress:\n      \"0x05574eb6b8789a91466f902c380d978e472db68170ff82a5b650b95a58ddf4ad\",\n    decimals: 18,\n  },\n  [ChainToken.STRK]: {\n    contractAddress:\n      \"0x04718f5a0fc34cc1af16a1cdee98ffb20c31f5cd61d6ab07201858f4287c938d\",\n    decimals: 18,\n  },\n  [ChainToken.ETH]: {\n    contractAddress:\n      \"0x049d36570d4e46f48e99674bd3fcc84644ddd6b96f7c741b1562b82f9e004dc7\",\n    decimals: 18,\n  },\n  [ChainToken.WBTC]: {\n    contractAddress:\n      \"0x03fe2b97c1fd336e750087d68b9b867997fd64a2661ff3ca5a7c771641e8e7ac\",\n    decimals: 8,\n  },\n  [ChainToken.SLINK]: {\n    contractAddress: \"\",\n    decimals: 18,\n  },\n  [ChainToken.ALF]: {\n    contractAddress: \"\",\n    decimals: 18,\n  },\n  [ChainToken.BROTHER]: {\n    contractAddress: \"\",\n    decimals: 18,\n  },\n  [ChainToken.ARB]: {\n    contractAddress: \"\",\n    decimals: 18,\n  },\n  [ChainToken.DOC]: {\n    contractAddress: \"\",\n    decimals: 18,\n  },\n  [ChainToken.MXNB]: {\n    contractAddress: \"\",\n    decimals: 18,\n  },\n  [ChainToken.WLD]: {\n    contractAddress: \"\",\n    decimals: 18,\n  },\n  [ChainToken.OTHER]: {\n    contractAddress: \"\",\n    decimals: 18,\n  },\n};\n"]}
+{"version":3,"sources":["../src/core.ts","../src/transaction.ts"],"names":["Chain","Currency","ChainToken","OnChainTxStatus"],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * Core configuration and environment types\n */\n\nexport interface ChipiSDKConfig {\n  apiPublicKey: string;\n  alphaUrl?: string;\n  nodeUrl?: string;\n  apiSecretKey?: string;\n}\n\nexport interface ChipiServerSDKConfig extends ChipiSDKConfig {\n  apiSecretKey: string;\n}\n\nexport interface ChipiBrowserSDKConfig extends Omit<ChipiSDKConfig, \"apiSecretKey\"> {\n  apiSecretKey?: never;\n}\n\nexport type alphaUrl = string;\n\nexport enum Chain {\n  STARKNET = \"STARKNET\",\n  BASE = \"BASE\",\n  ARBITRUM = \"ARBITRUM\",\n  OPTIMISM = \"OPTIMISM\",\n  ROOTSTOCK = \"ROOTSTOCK\",\n  SCROLL = \"SCROLL\",\n  WORLDCHAIN = \"WORLDCHAIN\",\n}\n\nexport enum Currency {\n  MXN = \"MXN\",\n  USD = \"USD\",\n}\n\nexport enum ChainToken {\n  USDC = \"USDC\",\n  USDC_E = \"USDC_E\",\n  USDT = \"USDT\",\n  DAI = \"DAI\",\n  ETH = \"ETH\",\n  STRK = \"STRK\",\n  SLINK = \"SLINK\",\n  ALF = \"ALF\",\n  BROTHER = \"BROTHER\",\n  ARB = \"ARB\",\n  DOC = \"DOC\",\n  MXNB = \"MXNB\",\n  WLD = \"WLD\",\n  WBTC = \"WBTC\",\n  OTHER = \"OTHER\",\n}\n\nexport interface PaginationQuery {\n  page?: number;\n  limit?: number;\n  offset?: number;\n}\n\nexport interface PaginatedResponse<T> {\n  data: T[];\n  total: number;\n  page: number;\n  limit: number;\n  totalPages: number;\n}\n\nexport const STARKNET_CONTRACTS: Record<ChainToken, { contractAddress: string; decimals: number }> =\n  {\n    [ChainToken.USDC]: {\n      contractAddress: \"0x033068F6539f8e6e6b131e6B2B814e6c34A5224bC66947c47DaB9dFeE93b35fb\",\n      decimals: 6,\n    },\n    [ChainToken.USDC_E]: {\n      contractAddress: \"0x053c91253bc9682c04929ca02ed00b3e423f6710d2ee7e0d5ebb06f3ecf368a8\",\n      decimals: 6,\n    },\n    [ChainToken.USDT]: {\n      contractAddress: \"0x068f5c6a61780768455de69077e07e89787839bf8166decfbf92b645209c0fb8\",\n      decimals: 6,\n    },\n    [ChainToken.DAI]: {\n      contractAddress: \"0x05574eb6b8789a91466f902c380d978e472db68170ff82a5b650b95a58ddf4ad\",\n      decimals: 18,\n    },\n    [ChainToken.STRK]: {\n      contractAddress: \"0x04718f5a0fc34cc1af16a1cdee98ffb20c31f5cd61d6ab07201858f4287c938d\",\n      decimals: 18,\n    },\n    [ChainToken.ETH]: {\n      contractAddress: \"0x049d36570d4e46f48e99674bd3fcc84644ddd6b96f7c741b1562b82f9e004dc7\",\n      decimals: 18,\n    },\n    [ChainToken.WBTC]: {\n      contractAddress: \"0x03fe2b97c1fd336e750087d68b9b867997fd64a2661ff3ca5a7c771641e8e7ac\",\n      decimals: 8,\n    },\n    [ChainToken.SLINK]: {\n      contractAddress: \"\",\n      decimals: 18,\n    },\n    [ChainToken.ALF]: {\n      contractAddress: \"\",\n      decimals: 18,\n    },\n    [ChainToken.BROTHER]: {\n      contractAddress: \"\",\n      decimals: 18,\n    },\n    [ChainToken.ARB]: {\n      contractAddress: \"\",\n      decimals: 18,\n    },\n    [ChainToken.DOC]: {\n      contractAddress: \"\",\n      decimals: 18,\n    },\n    [ChainToken.MXNB]: {\n      contractAddress: \"\",\n      decimals: 18,\n    },\n    [ChainToken.WLD]: {\n      contractAddress: \"\",\n      decimals: 18,\n    },\n    [ChainToken.OTHER]: {\n      contractAddress: \"\",\n      decimals: 18,\n    },\n  };\n","import type { Call, TypedData } from \"starknet\";\nimport type { WalletData, WalletType } from \"./wallet\";\nimport { Chain, ChainToken, Currency } from \"./core\";\n\n/**\n * Transaction-related types\n */\n\ntype PasskeyEnabledParams = {\n  usePasskey: true;\n  externalUserId: string;\n};\n\ntype PasskeyDisabledParams = {\n  usePasskey?: false;\n  externalUserId?: string;\n};\n\ntype PasskeyParams = PasskeyEnabledParams | PasskeyDisabledParams;\n\nexport type ExecuteTransactionParams = PasskeyParams & {\n  encryptKey?: string;\n  wallet: WalletData;\n  calls: Call[];\n};\n\nexport type TxType = string;\nexport type TxStatus = \"PENDING\" | \"PROCESSING\" | \"SUCCESS\" | \"FAILED\" | \"CANCELLED\";\n\nexport interface Transaction {\n  id: string;\n  type: TxType;\n  subType?: string;\n  chain: Chain;\n  transactionHash: string;\n\n  // Parties\n  senderAddress: string;\n  destinationAddress: string;\n\n  // Contract Interaction\n  contractAddress?: string;\n  contractName?: string;\n  functionName?: string;\n  functionSelector?: string;\n  callData?: unknown;\n\n  // Token Transfer (nullable for non-token operations)\n  token?: ChainToken;\n  tokenAddress?: string;\n  amount?: string;\n\n  // NFT Specific\n  nftTokenId?: string;\n  nftContract?: string;\n  nftMetadata?: Record<string, unknown>;\n\n  // SKU Specific\n  skuId?: string;\n  skuReference?: string;\n  skuPurchaseAmount?: number;\n  skuPurchaseCurrency?: Currency;\n  skuFileNumber?: string;\n\n  // Status\n  status: TxStatus;\n\n  // Timestamps\n  createdAt: Date;\n  confirmedAt?: Date;\n  updatedAt: Date;\n\n  // Relations\n  apiPublicKey: string;\n  chipiWalletId?: string;\n  destinationChipiWalletId?: string;\n}\n\nexport interface PrepareTypedDataParams {\n  calls: Call[];\n  walletAddress: string;\n}\n\nexport interface PrepareTypedDataResponse {\n  typedData: TypedData;\n  walletType: WalletType;\n}\n\nexport interface ExecuteSponsoredTransactionParams {\n  calls: Call[];\n  walletAddress: string;\n  signature: string[];\n  apiPublicKey: string;\n}\n\nexport interface ExecuteSponsoredTransactionResponse {\n  transactionHash: string;\n}\n\nexport interface RecordSendTransactionParams {\n  transactionHash: string;\n  expectedSender: string;\n  expectedRecipient: string;\n  expectedToken: ChainToken;\n  expectedAmount: string;\n  chain: Chain;\n}\n\n// Specific transaction types\nexport type TransferParams = PasskeyParams & {\n  encryptKey?: string;\n  wallet: WalletData;\n  token: ChainToken;\n  otherToken?: {\n    contractAddress: string;\n    decimals: number;\n  };\n  recipient: string;\n  amount: string;\n};\n\nexport type TransferHookInput = PasskeyParams & {\n  encryptKey?: string;\n  wallet: WalletData;\n  token: ChainToken;\n  otherToken?: {\n    contractAddress: string;\n    decimals: number;\n  };\n  recipient: string;\n  amount: number;\n};\n\nexport type ApproveParams = PasskeyParams & {\n  encryptKey?: string;\n  wallet: WalletData;\n  contractAddress: string;\n  spender: string;\n  amount: string;\n  decimals?: number;\n};\n\nexport type ApproveHookInput = PasskeyParams & {\n  encryptKey?: string;\n  wallet: WalletData;\n  contractAddress: string;\n  spender: string;\n  decimals?: number;\n  amount: number;\n};\n\nexport type CallAnyContractParams = PasskeyParams & {\n  encryptKey?: string;\n  wallet: WalletData;\n  contractAddress: string;\n  calls: Call[];\n};\n\nexport interface GetTransactionsParams {\n  page?: number;\n  limit?: number;\n  orgId: string;\n}\n\nexport interface GetTransactionListQuery {\n  page?: number;\n  limit?: number;\n  calledFunction?: string;\n  walletAddress: string; // Required: wallet address to filter transactions\n  day?: number; // Day of the month (1-31)\n  month?: number; // Month of the year (1-12)\n  year?: number; // Year (e.g., 2025)\n}\n\n/**\n * Parameters for fetching a single transaction by hash or internal ID.\n */\nexport interface GetTransactionParams {\n  /** Transaction hash (0x...) or internal database ID */\n  hashOrId: string;\n}\n\n/**\n * Parameters for fetching on-chain transaction status.\n */\nexport interface GetTransactionStatusParams {\n  /** Transaction hash (0x...) */\n  hash: string;\n}\n\n/**\n * On-chain transaction status from StarkNet sequencer.\n */\nexport enum OnChainTxStatus {\n  RECEIVED = \"RECEIVED\",\n  PENDING = \"PENDING\",\n  ACCEPTED_ON_L2 = \"ACCEPTED_ON_L2\",\n  ACCEPTED_ON_L1 = \"ACCEPTED_ON_L1\",\n  REJECTED = \"REJECTED\",\n  REVERTED = \"REVERTED\",\n  NOT_RECEIVED = \"NOT_RECEIVED\",\n}\n\n/**\n * Response from the transaction status endpoint.\n */\nexport interface TransactionStatusResponse {\n  /** Transaction hash */\n  transactionHash: string;\n  /** Current on-chain status */\n  status: OnChainTxStatus;\n  /** Block number (if included in a block) */\n  blockNumber?: number;\n  /** Revert reason (if status is REVERTED) */\n  revertReason?: string;\n}\n\n/**\n * Minimal account interface for PaymasterAdapter.\n * Compatible with starknet.js Account, external wallet objects, and Cartridge Controller.\n */\nexport interface PaymasterAccount {\n  address: string;\n  signMessage(typedData: TypedData): Promise<unknown>;\n  getClassHashAt(contractAddress: string): Promise<string>;\n}\n\n/**\n * Adapter for executing gasless (paymaster-sponsored) transactions.\n *\n * Handles the full flow: prepare typed data -> sign -> submit to paymaster.\n * For external wallets (Argent X, Braavos), `account.signMessage()` triggers the wallet popup.\n * For DirectSigner, signing happens programmatically.\n */\nexport interface PaymasterAdapter {\n  execute(params: { account: PaymasterAccount; calls: Call[] }): Promise<string>;\n}\n\n/**\n * Parameters for signing SNIP-12 typed data without executing a transaction.\n * Useful for x402 payment signatures and other off-chain signing flows.\n */\nexport interface SignTypedDataParams {\n  /** Encryption key (PIN) to decrypt the private key */\n  encryptKey: string;\n  /** Wallet data containing encrypted private key */\n  wallet: WalletData;\n  /** SNIP-12 typed data to sign */\n  typedData: TypedData;\n}\n\n/**\n * Result of signing SNIP-12 typed data.\n */\nexport interface SignTypedDataResult {\n  /** Signature r component */\n  r: string;\n  /** Signature s component */\n  s: string;\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chipi-stack/types",
-  "version": "13.14.0",
+  "version": "14.1.0",
   "description": "Type definitions for Chipi SDK packages",
   "keywords": [
     "chipi",