uvd-x402-sdk 2.15.2 → 2.16.2

package/dist/providers/sui/index.d.mts

@@ -0,0 +1,105 @@
+import { c as WalletAdapter, C as ChainConfig, P as PaymentInfo, m as X402Version } from '../../index-BE5cH7oS.mjs';
+
+/**
+ * uvd-x402-sdk - Sui Provider
+ *
+ * Provides wallet connection and payment creation for Sui blockchain.
+ * Uses sponsored transactions where the facilitator pays gas fees.
+ *
+ * @example Sui Mainnet
+ * ```ts
+ * import { SuiProvider } from 'uvd-x402-sdk/sui';
+ * import { getChainByName } from 'uvd-x402-sdk';
+ *
+ * const sui = new SuiProvider();
+ *
+ * // Connect
+ * const address = await sui.connect();
+ *
+ * // Create payment
+ * const chainConfig = getChainByName('sui')!;
+ * const paymentPayload = await sui.signPayment(paymentInfo, chainConfig);
+ * const header = sui.encodePaymentHeader(paymentPayload, chainConfig);
+ * ```
+ *
+ * @example Sui Testnet
+ * ```ts
+ * import { SuiProvider } from 'uvd-x402-sdk/sui';
+ * import { getChainByName } from 'uvd-x402-sdk';
+ *
+ * const sui = new SuiProvider();
+ *
+ * // Connect
+ * const address = await sui.connect();
+ *
+ * // Create testnet payment
+ * const chainConfig = getChainByName('sui-testnet')!;
+ * const paymentPayload = await sui.signPayment(paymentInfo, chainConfig);
+ * const header = sui.encodePaymentHeader(paymentPayload, chainConfig);
+ * ```
+ */
+
+/**
+ * SuiProvider - Wallet adapter for Sui blockchain
+ *
+ * Uses sponsored transactions where:
+ * 1. User creates a programmable transaction for token transfer
+ * 2. User signs the transaction
+ * 3. Facilitator sponsors (pays gas) and submits
+ */
+declare class SuiProvider implements WalletAdapter {
+    readonly id = "sui-wallet";
+    readonly name = "Sui Wallet";
+    readonly networkType: "sui";
+    private provider;
+    private clients;
+    private address;
+    /**
+     * Check if Sui wallet is available
+     */
+    isAvailable(): boolean;
+    /**
+     * Connect to Sui wallet
+     */
+    connect(): Promise<string>;
+    /**
+     * Disconnect from Sui wallet
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Get current address
+     */
+    getAddress(): string | null;
+    /**
+     * Get USDC balance
+     */
+    getBalance(chainConfig: ChainConfig): Promise<string>;
+    /**
+     * Create Sui payment (sponsored transaction)
+     *
+     * Transaction structure:
+     * 1. User creates a programmable transaction for USDC transfer
+     * 2. Transaction is signed by the user
+     * 3. Facilitator sponsors the transaction (pays gas in SUI)
+     * 4. Facilitator adds sponsor signature and submits
+     *
+     * User pays: ZERO SUI
+     */
+    signPayment(paymentInfo: PaymentInfo, chainConfig: ChainConfig): Promise<string>;
+    /**
+     * Encode Sui payment as X-PAYMENT header
+     *
+     * @param paymentPayload - JSON-encoded payment payload from signPayment()
+     * @param chainConfig - Chain configuration (optional, defaults to 'sui')
+     * @param version - x402 protocol version (1 or 2, defaults to 1)
+     * @returns Base64-encoded X-PAYMENT header value
+     */
+    encodePaymentHeader(paymentPayload: string, chainConfig?: ChainConfig, version?: X402Version): string;
+    private getSuiWalletProvider;
+    /**
+     * Get or create a Sui client for a specific chain
+     */
+    private getClient;
+}
+
+export { SuiProvider, SuiProvider as default };

package/dist/providers/sui/index.d.ts

@@ -0,0 +1,105 @@
+import { c as WalletAdapter, C as ChainConfig, P as PaymentInfo, m as X402Version } from '../../index-BE5cH7oS.js';
+
+/**
+ * uvd-x402-sdk - Sui Provider
+ *
+ * Provides wallet connection and payment creation for Sui blockchain.
+ * Uses sponsored transactions where the facilitator pays gas fees.
+ *
+ * @example Sui Mainnet
+ * ```ts
+ * import { SuiProvider } from 'uvd-x402-sdk/sui';
+ * import { getChainByName } from 'uvd-x402-sdk';
+ *
+ * const sui = new SuiProvider();
+ *
+ * // Connect
+ * const address = await sui.connect();
+ *
+ * // Create payment
+ * const chainConfig = getChainByName('sui')!;
+ * const paymentPayload = await sui.signPayment(paymentInfo, chainConfig);
+ * const header = sui.encodePaymentHeader(paymentPayload, chainConfig);
+ * ```
+ *
+ * @example Sui Testnet
+ * ```ts
+ * import { SuiProvider } from 'uvd-x402-sdk/sui';
+ * import { getChainByName } from 'uvd-x402-sdk';
+ *
+ * const sui = new SuiProvider();
+ *
+ * // Connect
+ * const address = await sui.connect();
+ *
+ * // Create testnet payment
+ * const chainConfig = getChainByName('sui-testnet')!;
+ * const paymentPayload = await sui.signPayment(paymentInfo, chainConfig);
+ * const header = sui.encodePaymentHeader(paymentPayload, chainConfig);
+ * ```
+ */
+
+/**
+ * SuiProvider - Wallet adapter for Sui blockchain
+ *
+ * Uses sponsored transactions where:
+ * 1. User creates a programmable transaction for token transfer
+ * 2. User signs the transaction
+ * 3. Facilitator sponsors (pays gas) and submits
+ */
+declare class SuiProvider implements WalletAdapter {
+    readonly id = "sui-wallet";
+    readonly name = "Sui Wallet";
+    readonly networkType: "sui";
+    private provider;
+    private clients;
+    private address;
+    /**
+     * Check if Sui wallet is available
+     */
+    isAvailable(): boolean;
+    /**
+     * Connect to Sui wallet
+     */
+    connect(): Promise<string>;
+    /**
+     * Disconnect from Sui wallet
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Get current address
+     */
+    getAddress(): string | null;
+    /**
+     * Get USDC balance
+     */
+    getBalance(chainConfig: ChainConfig): Promise<string>;
+    /**
+     * Create Sui payment (sponsored transaction)
+     *
+     * Transaction structure:
+     * 1. User creates a programmable transaction for USDC transfer
+     * 2. Transaction is signed by the user
+     * 3. Facilitator sponsors the transaction (pays gas in SUI)
+     * 4. Facilitator adds sponsor signature and submits
+     *
+     * User pays: ZERO SUI
+     */
+    signPayment(paymentInfo: PaymentInfo, chainConfig: ChainConfig): Promise<string>;
+    /**
+     * Encode Sui payment as X-PAYMENT header
+     *
+     * @param paymentPayload - JSON-encoded payment payload from signPayment()
+     * @param chainConfig - Chain configuration (optional, defaults to 'sui')
+     * @param version - x402 protocol version (1 or 2, defaults to 1)
+     * @returns Base64-encoded X-PAYMENT header value
+     */
+    encodePaymentHeader(paymentPayload: string, chainConfig?: ChainConfig, version?: X402Version): string;
+    private getSuiWalletProvider;
+    /**
+     * Get or create a Sui client for a specific chain
+     */
+    private getClient;
+}
+
+export { SuiProvider, SuiProvider as default };