@b3dotfun/sdk 0.1.68-alpha.3 → 0.1.68-alpha.5

package/dist/types/anyspend/platform/types.d.ts

@@ -0,0 +1,478 @@
+/**
+ * TypeScript types for the AnySpend Platform API.
+ */
+export interface ListResponse<T> {
+    object: "list";
+    data: T[];
+    has_more: boolean;
+    total_count: number;
+    url: string;
+}
+export interface DeletedResponse {
+    object: string;
+    id: string;
+    deleted: true;
+}
+export interface ActionResponse {
+    object: "action";
+    action: string;
+    [key: string]: unknown;
+}
+export interface PaginationParams {
+    page?: number;
+    limit?: number;
+}
+export interface PaymentLink {
+    object: "payment_link";
+    id: string;
+    short_code: string;
+    url?: string;
+    name: string;
+    description: string | null;
+    amount: string | null;
+    min_amount: string | null;
+    max_amount: string | null;
+    suggested_amount: string | null;
+    token_address: string;
+    chain_id: number;
+    recipient_address: string;
+    product_id: string | null;
+    image_url: string | null;
+    theme_color: string | null;
+    button_text: string;
+    max_uses: number | null;
+    current_uses: number;
+    expires_at: number | null;
+    is_active: boolean;
+    form_schema: string | null;
+    shipping_options: string | null;
+    collect_shipping_address: boolean;
+    return_url: string | null;
+    return_label: string | null;
+    branding: string | null;
+    fee_on_top: boolean;
+    items?: PaymentLinkItem[];
+    created_at: number;
+    updated_at: number;
+}
+export interface PaymentLinkItem {
+    object: "payment_link_item";
+    id: string;
+    payment_link_id: string;
+    product_id: string | null;
+    name: string;
+    description: string | null;
+    image_url: string | null;
+    amount: string;
+    quantity: number;
+    sort_order: number;
+    created_at: number;
+    updated_at: number;
+}
+export interface CreatePaymentLinkParams {
+    name: string;
+    token_address: string;
+    chain_id: number;
+    recipient_address: string;
+    description?: string;
+    amount?: string;
+    min_amount?: string;
+    max_amount?: string;
+    suggested_amount?: string;
+    product_id?: string;
+    image_url?: string;
+    theme_color?: string;
+    button_text?: string;
+    max_uses?: number;
+    expires_at?: number;
+    form_schema?: Record<string, unknown>;
+    shipping_options?: Record<string, unknown>[];
+    collect_shipping_address?: boolean;
+    return_url?: string;
+    return_label?: string;
+    branding?: Record<string, unknown>;
+    fee_on_top?: boolean;
+    items?: CreatePaymentLinkItemParams[];
+}
+export interface CreatePaymentLinkItemParams {
+    name: string;
+    amount: string;
+    description?: string;
+    image_url?: string;
+    quantity?: number;
+    sort_order?: number;
+    product_id?: string;
+}
+export interface UpdatePaymentLinkParams extends Partial<Omit<CreatePaymentLinkParams, "items">> {
+    is_active?: boolean;
+    items?: CreatePaymentLinkItemParams[];
+}
+export interface ListPaymentLinksParams extends PaginationParams {
+    search?: string;
+    active?: "true" | "false";
+    sort?: "created_at" | "updated_at" | "name" | "current_uses";
+    order?: "asc" | "desc";
+}
+export interface PaymentLinkStats {
+    object: "payment_link_stats";
+    payment_link_id: string;
+    summary: {
+        total_views: number;
+        total_sessions: number;
+        total_completions: number;
+        lifetime_completions: number;
+        view_to_session_rate: string;
+        session_to_completion_rate: string;
+        overall_conversion_rate: string;
+    };
+    daily: {
+        views: {
+            date: string;
+            view_count: number;
+            unique_visitors: number;
+        }[];
+        sessions: {
+            date: string;
+            sessions: number;
+            completions: number;
+        }[];
+    };
+    utm_breakdown: Record<string, unknown>[];
+}
+export interface Product {
+    object: "product";
+    id: string;
+    name: string;
+    description: string | null;
+    image_url: string | null;
+    amount: string;
+    token_address: string;
+    chain_id: number;
+    recipient_address: string | null;
+    product_type: "one_time" | "subscription" | "variable";
+    is_active: boolean;
+    metadata: Record<string, unknown> | null;
+    form_schema: string | null;
+    shipping_options: string | null;
+    created_at: number;
+    updated_at: number;
+}
+export interface CreateProductParams {
+    name: string;
+    amount: string;
+    token_address: string;
+    chain_id: number;
+    description?: string;
+    image_url?: string;
+    recipient_address?: string;
+    product_type?: "one_time" | "subscription" | "variable";
+    metadata?: Record<string, unknown>;
+    form_schema?: Record<string, unknown>;
+    shipping_options?: Record<string, unknown>[];
+}
+export interface UpdateProductParams extends Partial<CreateProductParams> {
+    is_active?: boolean;
+}
+export interface Customer {
+    object: "customer";
+    id: string;
+    wallet_address: string;
+    name: string | null;
+    email: string | null;
+    metadata: Record<string, unknown> | null;
+    total_paid: string | null;
+    transaction_count: number;
+    first_payment_at: number | null;
+    last_payment_at: number | null;
+    created_at: number;
+    updated_at: number;
+}
+export interface CreateCustomerParams {
+    wallet_address: string;
+    name?: string;
+    email?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface UpdateCustomerParams {
+    name?: string;
+    email?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface Transaction {
+    object: "transaction";
+    id: string;
+    tx_hash: string;
+    chain_id: number;
+    from_address: string;
+    to_address: string;
+    token_address: string;
+    amount: string;
+    amount_usd: string | null;
+    status: "pending" | "confirming" | "completed" | "failed";
+    payment_link_id: string | null;
+    customer_id: string | null;
+    created_at: number;
+    updated_at: number;
+}
+export interface TransactionStats {
+    object: "transaction_stats";
+    totalTransactions: number;
+    completedTransactions: number;
+    totalVolumeUsd: string;
+    last24h: {
+        transactions: number;
+        volumeUsd: string;
+    };
+    statusBreakdown: Record<string, number>;
+}
+export interface ListTransactionsParams extends PaginationParams {
+    status?: string;
+    customer_id?: string;
+    payment_link_id?: string;
+    from?: number;
+    to?: number;
+}
+export interface CheckoutSession {
+    object: "checkout_session";
+    id: string;
+    url: string | null;
+    status: "open" | "processing" | "completed" | "expired" | "failed";
+    payment_link_id: string | null;
+    product_id: string | null;
+    amount: string | null;
+    token_address: string;
+    chain_id: number;
+    recipient_address: string;
+    success_url: string | null;
+    cancel_url: string | null;
+    client_reference_id: string | null;
+    /** The API returns metadata as a serialized JSON string. Use JSON.parse() to recover the original object. */
+    metadata: string | null;
+    customer_email: string | null;
+    customer_name: string | null;
+    tx_hash: string | null;
+    completed_at: number | null;
+    expires_at: number;
+    created_at: number;
+    updated_at: number;
+}
+export interface CreateCheckoutSessionParams {
+    payment_link_id?: string;
+    token_address?: string;
+    chain_id?: number;
+    recipient_address?: string;
+    amount?: string;
+    product_id?: string;
+    success_url?: string;
+    cancel_url?: string;
+    client_reference_id?: string;
+    metadata?: Record<string, unknown>;
+    customer_email?: string;
+    customer_name?: string;
+    expires_in?: number;
+    utm_source?: string;
+    utm_medium?: string;
+    utm_campaign?: string;
+}
+export interface Webhook {
+    object: "webhook";
+    id: string;
+    url: string;
+    events: string[];
+    secret?: string;
+    is_active: boolean;
+    success_count: number;
+    failure_count: number;
+    last_triggered_at: number | null;
+    created_at: number;
+    updated_at: number;
+}
+export interface CreateWebhookParams {
+    url: string;
+    events: string[];
+    description?: string;
+}
+export interface UpdateWebhookParams {
+    url?: string;
+    events?: string[];
+    is_active?: boolean;
+}
+export interface DiscountCode {
+    object: "discount_code";
+    id: string;
+    code: string;
+    type: "percentage" | "fixed";
+    value: string;
+    payment_link_id: string | null;
+    max_uses: number | null;
+    current_uses: number;
+    min_order_amount: string | null;
+    expires_at: number | null;
+    is_active: boolean;
+    created_at: number;
+    updated_at: number;
+}
+export interface CreateDiscountCodeParams {
+    code: string;
+    type: "percentage" | "fixed";
+    value: string;
+    payment_link_id?: string;
+    max_uses?: number;
+    min_order_amount?: string;
+    expires_at?: number;
+}
+export interface BatchCreateDiscountCodesParams {
+    codes: string[];
+    type: "percentage" | "fixed";
+    value: string;
+    payment_link_id?: string;
+    max_uses?: number;
+    min_order_amount?: string;
+    expires_at?: number;
+}
+export interface NotificationSettings {
+    object: "notification_settings";
+    id: string;
+    email_enabled: boolean;
+    email_address: string | null;
+    telegram_enabled: boolean;
+    telegram_chat_id: string | null;
+    enabled_events: string[];
+}
+export interface UpdateNotificationSettingsParams {
+    email_enabled?: boolean;
+    email_address?: string;
+    telegram_enabled?: boolean;
+    enabled_events?: string[];
+}
+export interface WidgetConfig {
+    object: "widget_config";
+    id: string;
+    short_code: string;
+    name: string;
+    description: string | null;
+    widget_type: string;
+    config: string;
+    theme: string;
+    is_active: boolean;
+    current_views: number;
+    created_at: number;
+    updated_at: number;
+}
+export interface CreateWidgetParams {
+    name: string;
+    widget_type: "swap" | "checkout" | "nft" | "deposit";
+    config: Record<string, unknown>;
+    description?: string;
+    theme?: Record<string, unknown>;
+}
+export interface Organization {
+    object: "organization";
+    id: string;
+    name: string;
+    slug: string;
+    description: string | null;
+    logo_url: string | null;
+    website_url: string | null;
+    default_recipient_address: string | null;
+    default_chain_id: number | null;
+    default_token_address: string | null;
+}
+export interface AnalyticsOverview {
+    object: "analytics_overview";
+    period: string;
+    revenue: {
+        period_usd: string;
+        period_transactions: number;
+        all_time_usd: string;
+        all_time_transactions: number;
+    };
+    customers: {
+        total: number;
+        new_in_period: number;
+    };
+    payment_links: {
+        total: number;
+        active: number;
+    };
+    conversion_rate: string;
+    daily: {
+        date: string;
+        transactions: number;
+        revenue_usd: number;
+    }[];
+    top_payment_links: Record<string, unknown>[];
+    top_tokens: Record<string, unknown>[];
+    top_chains: Record<string, unknown>[];
+}
+export interface ApiEvent {
+    object: "event";
+    id: string;
+    event_type: string;
+    resource_type: string;
+    resource_id: string | null;
+    ip_address: string | null;
+    request_method: string;
+    request_path: string;
+    status_code: number;
+    created_at: number;
+}
+export interface QuickPayParams {
+    recipient_address: string;
+    amount?: string;
+    token_address?: string;
+    chain_id?: number;
+    name?: string;
+    description?: string;
+    expires_in?: number;
+}
+export interface ApiKey {
+    object: "api_key";
+    id: string;
+    name: string;
+    prefix: string;
+    permissions: string[];
+    last_used_at: number | null;
+    created_at: number;
+    updated_at: number;
+}
+export interface WebhookDelivery {
+    object: "webhook_delivery";
+    id: string;
+    webhook_id: string;
+    event_type: string;
+    url: string;
+    status: "pending" | "success" | "failed";
+    status_code: number | null;
+    response_body: string | null;
+    error_message: string | null;
+    attempted_at: number;
+    created_at: number;
+}
+export interface ValidateDiscountResult {
+    object: "discount_validation";
+    valid: boolean;
+    discount_code?: DiscountCode;
+    discount_amount?: string;
+    final_amount?: string;
+    reason?: string;
+}
+export interface BatchCreateResult {
+    object: "batch_result";
+    created: DiscountCode[];
+    errors: {
+        code: string;
+        error: string;
+    }[];
+}
+export interface ExportTransactionsParams {
+    format?: "csv" | "json";
+    status?: string;
+    from?: number;
+    to?: number;
+}
+export interface ExportCustomersParams {
+    format?: "csv" | "json";
+    from?: number;
+    to?: number;
+}

package/dist/types/anyspend/platform/utils/idempotency.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Idempotency key generation utility.
+ */
+export declare function generateIdempotencyKey(): string;

package/dist/types/anyspend/platform/utils/pagination.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Auto-pagination async iterator for list endpoints.
+ */
+import type { ListResponse } from "../types";
+export interface AutoPaginateOptions {
+    startPage?: number;
+    limit?: number;
+}
+/**
+ * Creates an async iterator that automatically paginates through all results.
+ */
+export declare function autoPaginate<T>(fetchPage: (page: number, limit: number) => Promise<ListResponse<T>>, options?: AutoPaginateOptions): AsyncGenerator<T, void, undefined>;

package/dist/types/anyspend/react/components/AnySpend.d.ts

@@ -18,7 +18,9 @@ export declare enum PanelView {
     FIAT_PAYMENT_METHOD = 7,
     POINTS_DETAIL = 8,
     FEE_DETAIL = 9,
-    DIRECT_TRANSFER_SUCCESS = 10
+    DIRECT_TRANSFER_SUCCESS = 10,
+    FIAT_KYC = 11,
+    FIAT_AUTH = 12
 }
 export declare function AnySpend(props: {
     mode?: "page" | "modal";

package/dist/types/anyspend/react/components/checkout/KycGate.d.ts

@@ -0,0 +1,11 @@
+import type { AnySpendCheckoutClasses } from "./AnySpendCheckout";
+interface KycGateProps {
+    themeColor?: string;
+    classes?: AnySpendCheckoutClasses;
+    /** Only fetch KYC status (and prompt wallet signature) when true. */
+    enabled?: boolean;
+    /** Called when KYC status is resolved (approved or not required) */
+    onStatusResolved: (approved: boolean) => void;
+}
+export declare function KycGate({ themeColor, classes, enabled, onStatusResolved }: KycGateProps): import("react/jsx-runtime").JSX.Element | null;
+export {};

package/dist/types/anyspend/react/hooks/index.d.ts

@@ -18,3 +18,4 @@ export * from "./useSigMint";
 export * from "./useStripeClientSecret";
 export * from "./useStripeSupport";
 export * from "./useWatchTransfer";
+export * from "./useKycStatus";

package/dist/types/anyspend/react/hooks/useKycStatus.d.ts

@@ -0,0 +1,42 @@
+export interface KycStatusResponse {
+    kycRequired: boolean;
+    status: "not_verified" | "pending" | "completed" | "approved" | "declined" | "needs_review" | "expired";
+    inquiry?: {
+        inquiryId: string;
+        sessionToken: string;
+    };
+    config?: {
+        templateId: string;
+        environment: string;
+    };
+}
+interface KycInquiryResponse {
+    inquiryId: string;
+    sessionToken: string;
+}
+interface KycVerifyResponse {
+    status: string;
+}
+/**
+ * Returns a function that builds the wallet-signature auth headers.
+ * Caches signatures for 4 minutes (server allows 5-minute window).
+ */
+export declare function useWalletAuthHeaders(): {
+    address: `0x${string}` | undefined;
+    getHeaders: () => Promise<Record<string, string>>;
+};
+export declare function useKycStatus(enabled?: boolean): {
+    kycStatus: KycStatusResponse | null;
+    isLoadingKycStatus: boolean;
+    kycStatusError: Error | null;
+    refetchKycStatus: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<KycStatusResponse, Error>>;
+};
+export declare function useCreateKycInquiry(): {
+    createInquiry: import("@tanstack/react-query").UseMutateAsyncFunction<KycInquiryResponse, Error, void, unknown>;
+    isCreatingInquiry: boolean;
+};
+export declare function useVerifyKyc(): {
+    verifyKyc: import("@tanstack/react-query").UseMutateAsyncFunction<KycVerifyResponse, Error, string, unknown>;
+    isVerifying: boolean;
+};
+export {};

package/dist/types/anyspend/services/anyspend.d.ts

@@ -6,7 +6,7 @@ export declare const anyspendService: {
     getTokenList: (chainId: number, query: string) => Promise<components["schemas"]["Token"][]>;
     getToken: (chainId: number, tokenAddress: string) => Promise<components["schemas"]["Token"]>;
     getQuote: (req: GetQuoteRequest, partnerId?: string) => Promise<GetQuoteResponse>;
-    createOrder: ({ recipientAddress, type, srcChain, dstChain, srcTokenAddress, dstTokenAddress, srcAmount, payload, onramp, metadata, creatorAddress, partnerId, clientReferenceId, visitorData, callbackMetadata, feeOnTop, }: {
+    createOrder: ({ recipientAddress, type, srcChain, dstChain, srcTokenAddress, dstTokenAddress, srcAmount, payload, onramp, metadata, creatorAddress, partnerId, clientReferenceId, visitorData, callbackMetadata, feeOnTop, kycWalletHeaders, }: {
         recipientAddress: string;
         type: string;
         srcChain: number;
@@ -23,6 +23,8 @@ export declare const anyspendService: {
         visitorData?: VisitorData;
         callbackMetadata?: Record<string, unknown>;
         feeOnTop?: boolean;
+        /** Wallet signature auth headers for KYC lookup (stripe-web2 orders only). */
+        kycWalletHeaders?: Record<string, string>;
     }) => Promise<{
         success: boolean;
         message: string;

package/dist/types/global-account/react/stores/useModalStore.d.ts

@@ -657,6 +657,10 @@ interface ModalState {
     setLinkingState: (isLinking: boolean, method?: string | null) => void;
     /** Function to update closable property of current content without adding to history */
     setClosable: (closable: boolean) => void;
+    /** Whether a third-party iframe (e.g. Persona KYC) is currently active over the modal */
+    personaActive: boolean;
+    /** Function to mark a third-party iframe as active/inactive */
+    setPersonaActive: (active: boolean) => void;
 }
 /**
  * Zustand store for managing modal state

package/dist/types/global-account/react/utils/createWagmiConfig.d.ts

@@ -25,3 +25,21 @@ export declare function createWagmiConfig(options: CreateWagmiConfigOptions): im
 }, {
     "thirdweb:lastChainId": number;
 }>)[]>;
+/**
+ * Returns a cached wagmi config for the given partnerId.
+ * Use this instead of calling createWagmiConfig() directly inside React components or hooks
+ * to avoid registering duplicate EventEmitter listeners on every render.
+ */
+export declare function getCachedWagmiConfig(options: CreateWagmiConfigOptions): import("wagmi").Config<readonly [import("viem").Chain, ...import("viem").Chain[]], {
+    [k: string]: import("viem").HttpTransport<undefined, false>;
+}, (CreateConnectorFn | CreateConnectorFn<import("thirdweb/dist/types/adapters/eip1193").EIP1193Provider | undefined, {
+    connect<withCapabilities extends boolean = false>(parameters?: import("@thirdweb-dev/wagmi-adapter").ConnectionOptions<withCapabilities> | undefined): Promise<{
+        accounts: withCapabilities extends true ? readonly {
+            address: `0x${string}`;
+            capabilities: Record<string, unknown>;
+        }[] : readonly `0x${string}`[];
+        chainId: number;
+    }>;
+}, {
+    "thirdweb:lastChainId": number;
+}>)[]>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@b3dotfun/sdk",
-  "version": "0.1.68-alpha.3",
+  "version": "0.1.68-alpha.5",
   "source": "src/index.ts",
   "main": "./dist/cjs/index.js",
   "react-native": "./dist/cjs/index.native.js",
@@ -55,6 +55,11 @@
       "import": "./dist/esm/anyspend/constants.js",
       "require": "./dist/cjs/anyspend/constants.js"
     },
+    "./anyspend/platform": {
+      "types": "./dist/types/anyspend/platform/index.d.ts",
+      "import": "./dist/esm/anyspend/platform/index.js",
+      "require": "./dist/cjs/anyspend/platform/index.js"
+    },
     "./anyspend/services/*": {
       "types": "./dist/types/anyspend/services/*.d.ts",
       "import": "./dist/esm/anyspend/services/*.js",
@@ -324,6 +329,7 @@
     "js-cookie": "3.0.5",
     "lucide-react": "0.424.0",
     "motion": "^12.23.11",
+    "persona": "^5.7.0",
     "qrcode.react": "4.2.0",
     "react-easy-crop": "^5.5.3",
     "react-intersection-observer": "9.16.0",