@proofchain/sdk 2.1.1 → 2.3.0

package/dist/index.d.mts

@@ -1007,13 +1007,6 @@ interface WalletBalance {
     network: string;
     balances: TokenBalance[];
 }
-interface TokenBalance {
-    token: string;
-    symbol: string;
-    balance: string;
-    decimals: number;
-    usd_value?: number;
-}
 interface NFT {
     id: string;
     wallet_id: string;
@@ -1157,11 +1150,20 @@ interface AddNFTRequest {
     source?: string;
 }
 interface TransferRequest {
-    from_address: string;
+    /** Source wallet address (required if wallet_id not provided) */
+    from_address?: string;
+    /** Source wallet ID (alternative to from_address) */
+    wallet_id?: string;
+    /** Destination address */
     to_address: string;
+    /** Amount to transfer (in token units, e.g., "0.1" for 0.1 ETH) */
     amount: string;
+    /** Token symbol (default: "ETH") */
     token?: string;
+    /** Network (default: "base-sepolia") */
     network?: string;
+    /** Contract address for custom ERC-20 tokens */
+    contract_address?: string;
 }
 interface TransferResult {
     tx_hash: string;
@@ -1169,9 +1171,80 @@ interface TransferResult {
     to: string;
     amount: string;
     token: string;
+    contract_address?: string;
     network: string;
     status: string;
 }
+interface Token {
+    id: string;
+    contract_address: string;
+    network: string;
+    symbol: string;
+    name: string;
+    decimals: number;
+    logo_url?: string;
+    color?: string;
+    coingecko_id?: string;
+    coinmarketcap_id?: string;
+    token_standard: string;
+    is_native_wrapper: boolean;
+    is_verified: boolean;
+    is_active: boolean;
+    is_hidden?: boolean;
+    display_order: number;
+    is_global: boolean;
+}
+interface CreateTokenRequest {
+    contract_address: string;
+    network: string;
+    symbol: string;
+    name: string;
+    decimals?: number;
+    logo_url?: string;
+    color?: string;
+    coingecko_id?: string;
+    coinmarketcap_id?: string;
+    custom_price_feed_url?: string;
+    is_native_wrapper?: boolean;
+    display_order?: number;
+}
+interface UpdateTokenRequest {
+    symbol?: string;
+    name?: string;
+    decimals?: number;
+    logo_url?: string;
+    color?: string;
+    coingecko_id?: string;
+    coinmarketcap_id?: string;
+    custom_price_feed_url?: string;
+    is_active?: boolean;
+    is_hidden?: boolean;
+    display_order?: number;
+}
+interface TokenBalance {
+    token: string;
+    symbol: string;
+    balance: string;
+    decimals: number;
+    usd_value?: number;
+}
+interface TokenBalance {
+    token: string;
+    balance: string;
+    raw_balance?: string;
+    contract_address?: string;
+    decimals: number;
+    name?: string;
+    logo_url?: string;
+    source: 'cdp' | 'custom' | 'global';
+}
+interface WalletBalanceResponse {
+    address: string;
+    network: string;
+    native_balance: string;
+    native_symbol: string;
+    balances: TokenBalance[];
+}
 interface UserWithWallets {
     user_id: string;
     wallets: Array<{
@@ -1225,9 +1298,11 @@ declare class WalletClient {
      */
     createDualBulk(userIds: string[], network?: string): Promise<DualWallets[]>;
     /**
-     * Get wallet balance
+     * Get wallet balance including custom tokens.
+     *
+     * Returns native balance (ETH) plus all registered token balances.
      */
-    getBalance(walletId: string): Promise<WalletBalance>;
+    getBalance(walletId: string): Promise<WalletBalanceResponse>;
     /**
      * Get comprehensive wallet information in a single call.
      *
@@ -1265,21 +1340,33 @@ declare class WalletClient {
         warning: string;
     }>;
     /**
-     * Transfer tokens from one address to another.
+     * Transfer tokens from a CDP wallet to any address.
+     *
+     * Supports native ETH and ERC-20 tokens. The source wallet must be a CDP-managed wallet.
      *
-     * @param request - Transfer details
+     * @param request - Transfer details (use wallet_id or from_address)
      * @returns Transaction result with hash and status
      *
      * @example
      * ```typescript
+     * // Transfer ETH using wallet_id
      * const result = await client.wallets.transfer({
-     *   from_address: '0x123...',
+     *   wallet_id: 'd1096269-f986-4fa6-a1f5-1a29ef69f6e4',
      *   to_address: '0x456...',
-     *   amount: '0.1',
+     *   amount: '0.0001',
      *   token: 'ETH',
-     *   network: 'base-sepolia',
+     *   network: 'base-mainnet',
      * });
      * console.log('TX Hash:', result.tx_hash);
+     *
+     * // Transfer using from_address
+     * const result2 = await client.wallets.transfer({
+     *   from_address: '0xaA2e82E5fCF97003d409Bc90826F40cfc8F27510',
+     *   to_address: '0x456...',
+     *   amount: '0.0001',
+     *   token: 'ETH',
+     *   network: 'base-mainnet',
+     * });
      * ```
      */
     transfer(request: TransferRequest): Promise<TransferResult>;
@@ -1318,6 +1405,63 @@ declare class WalletClient {
         limit?: number;
         offset?: number;
     }): Promise<TransactionHistory>;
+    /**
+     * Register a custom token for the tenant.
+     *
+     * This allows tracking balances and enabling transfers for custom ERC-20 tokens.
+     *
+     * @param request - Token details including contract address, symbol, decimals
+     * @returns The created token
+     *
+     * @example
+     * ```typescript
+     * const token = await client.wallets.createToken({
+     *   contract_address: '0x...',
+     *   network: 'base-mainnet',
+     *   symbol: 'wSOL',
+     *   name: 'Wrapped Solana',
+     *   decimals: 9,
+     * });
+     * ```
+     */
+    createToken(request: CreateTokenRequest): Promise<Token>;
+    /**
+     * List all tokens available to the tenant.
+     *
+     * Returns both tenant-specific tokens and global tokens.
+     *
+     * @param options - Filter options
+     */
+    listTokens(options?: {
+        network?: string;
+        include_global?: boolean;
+        include_hidden?: boolean;
+    }): Promise<Token[]>;
+    /**
+     * List global tokens (available to all tenants).
+     *
+     * These are well-known tokens like USDC, WETH, DAI, etc.
+     */
+    listGlobalTokens(network?: string): Promise<Token[]>;
+    /**
+     * Get a specific token by ID.
+     */
+    getToken(tokenId: string): Promise<Token>;
+    /**
+     * Get a token by contract address and network.
+     */
+    getTokenByContract(contractAddress: string, network: string): Promise<Token>;
+    /**
+     * Update a custom token.
+     */
+    updateToken(tokenId: string, request: UpdateTokenRequest): Promise<Token>;
+    /**
+     * Delete a custom token (soft delete).
+     */
+    deleteToken(tokenId: string): Promise<{
+        message: string;
+        token_id: string;
+    }>;
 }
 
 /**
@@ -1714,15 +1858,27 @@ interface UserQuestProgress {
     user_id: string;
     quest_id: string;
     quest_name: string;
-    status: 'not_started' | 'in_progress' | 'completed' | 'failed' | 'expired';
+    status: 'not_started' | 'in_progress' | 'completed' | 'failed' | 'expired' | 'reward_pending';
     started_at?: string;
     completed_at?: string;
     expires_at?: string;
     completion_count: number;
     current_step_order: number;
+    steps_completed: number;
+    total_steps: number;
+    completion_percentage: number;
     step_progress: StepProgress[];
     points_earned: number;
-    reward_earned: boolean;
+    reward_earned?: RewardEarned;
+}
+interface RewardEarned {
+    id: string;
+    reward_name: string;
+    reward_type: string;
+    value?: number;
+    value_currency?: string;
+    status: string;
+    earned_at: string;
 }
 interface StepProgress {
     step_id: string;
@@ -1732,6 +1888,14 @@ interface StepProgress {
     completed_at?: string;
     event_id?: string;
 }
+interface StepCompletionResult {
+    step_index: number;
+    step_completed: boolean;
+    quest_completed: boolean;
+    current_count: number;
+    target_count: number;
+    points_earned: number;
+}
 interface QuestWithProgress extends Quest {
     user_progress?: UserQuestProgress;
 }
@@ -1794,6 +1958,13 @@ declare class QuestsClient {
      * Get a quest by ID
      */
     get(questId: string): Promise<Quest>;
+    /**
+     * List available quests for a user (active, public quests with user progress)
+     * This is the main endpoint for frontend quest displays
+     */
+    listAvailable(userId: string, options?: {
+        category?: string;
+    }): Promise<QuestWithProgress[]>;
     /**
      * Get a quest by slug
      */
@@ -1811,7 +1982,11 @@ declare class QuestsClient {
      */
     delete(questId: string): Promise<void>;
     /**
-     * Activate a quest
+     * Publish/activate a quest (changes status from draft to active)
+     */
+    publish(questId: string): Promise<Quest>;
+    /**
+     * @deprecated Use publish() instead
      */
     activate(questId: string): Promise<Quest>;
     /**
@@ -1839,9 +2014,9 @@ declare class QuestsClient {
      */
     getUserProgress(questId: string, userId: string): Promise<UserQuestProgress>;
     /**
-     * Complete a step manually
+     * Complete a step manually by step index
      */
-    completeStep(questId: string, userId: string, stepId: string): Promise<UserQuestProgress>;
+    completeStep(questId: string, userId: string, stepIndex: number): Promise<StepCompletionResult>;
     /**
      * Get all quest progress for a user
      */
@@ -2609,4 +2784,4 @@ declare class TimeoutError extends ProofChainError {
     constructor(message?: string);
 }
 
-export { type Achievement, type ActivitySummaryView, type AddNFTRequest, type ApiKey, type AttestRequest, type AttestationMode, type AttestationResult, AuthenticationError, AuthorizationError, type AvailableView, type Badge, type BatchIngestRequest, type BatchIngestResponse, type BatchVerifyResult, type BlockchainProof, type BlockchainStats, type Certificate, type CertificateVerifyResult, CertificatesResource, type Channel, type ChannelState, type ChannelStatus, ChannelsResource, type ComprehensiveWalletInfo, type CreateAchievementRequest, type CreateApiKeyRequest, type CreateBadgeRequest, type CreateChannelRequest, type CreateDataViewRequest, type CreateDualWalletsRequest, type CreateEndUserRequest, type CreateEventRequest, type CreatePassportDefinitionRequest, type CreatePassportRequest, type CreateQuestRequest, type CreateQuestStepRequest, type CreateRewardDefinitionRequest, type CreateSchemaRequest, type CreateTemplateFieldRequest, type CreateTemplateRequest, type CreateWalletRequest, type CreateWebhookRequest, type DataViewColumn, type DataViewComputation, type DataViewDetail, type DataViewExecuteResult, type DataViewInfo, type DataViewListResponse, type DataViewPreviewRequest, type DataViewPreviewResult, type DataViewSummary, DataViewsClient, DocumentsResource, type DualWallets, type EarnedReward, type EndUser, type EndUserListResponse, EndUsersClient, type Event, type EventBatchProof, type EventMetadata, type EventStatus, EventsResource, type ExecuteSwapRequest, type Facet, type FacetsResponse, type FanProfileView, type FieldValue, type IngestEventRequest, type IngestEventResponse, IngestionClient, type IngestionClientOptions, type IssueCertificateRequest, type LinkWalletRequest, type ListCertificatesRequest, type ListEndUsersOptions, type ListEventsRequest, type ListQuestsOptions, type ListRewardsOptions, type ListSchemasOptions, type ManualRewardRequest, type MergeUsersRequest, type Milestone, type NFT, NetworkError, NotFoundError, type Passport, PassportClient, type PassportDefinition, type PassportFieldValue, type PassportHistory, type PassportTemplate, type PassportV2Data, type PassportWithFields, ProofChain, ProofChainError, type ProofChainOptions, type ProofVerifyResult, type Quest, type QuestStep, type QuestWithProgress, QuestsClient, RateLimitError, type RewardAsset, type RewardDefinition, RewardsClient, type Schema, type SchemaDetail, type SchemaField, type SchemaListResponse, type ValidationError$1 as SchemaValidationError, SchemasClient, type SearchFilters, type SearchQueryRequest, type SearchRequest, SearchResource, type SearchResponse, type SearchResult, type SearchStats, ServerError, type Settlement, type StepProgress, type StreamAck, type StreamEventRequest, type SwapQuote, type SwapQuoteRequest, type SwapResult, type TemplateField, type TenantInfo, TenantResource, type TierDefinition, TimeoutError, type TokenBalance, type TransferRequest, type TransferResult, type UpdateDataViewRequest, type UpdateEndUserRequest, type UpdatePassportRequest, type UpdateWebhookRequest, type UsageStats, type UserAchievement, type UserActivity, type UserActivityResponse, type UserBadge, type UserQuestProgress, type UserWalletSummary, type UserWithWallets, type UsersWithWalletsResponse, type ValidateDataRequest, ValidationError, type ValidationErrorDetail, type ValidationResult, type VaultFile, type VaultFolder, type VaultListResponse, VaultResource, type VaultStats, type VaultUploadRequest, type VerificationResult, VerifyResource, type ViewColumn, type ViewTemplate, type Wallet, type WalletBalance, WalletClient, type WalletStats, type Webhook, WebhooksResource };
+export { type Achievement, type ActivitySummaryView, type AddNFTRequest, type ApiKey, type AttestRequest, type AttestationMode, type AttestationResult, AuthenticationError, AuthorizationError, type AvailableView, type Badge, type BatchIngestRequest, type BatchIngestResponse, type BatchVerifyResult, type BlockchainProof, type BlockchainStats, type Certificate, type CertificateVerifyResult, CertificatesResource, type Channel, type ChannelState, type ChannelStatus, ChannelsResource, type ComprehensiveWalletInfo, type CreateAchievementRequest, type CreateApiKeyRequest, type CreateBadgeRequest, type CreateChannelRequest, type CreateDataViewRequest, type CreateDualWalletsRequest, type CreateEndUserRequest, type CreateEventRequest, type CreatePassportDefinitionRequest, type CreatePassportRequest, type CreateQuestRequest, type CreateQuestStepRequest, type CreateRewardDefinitionRequest, type CreateSchemaRequest, type CreateTemplateFieldRequest, type CreateTemplateRequest, type CreateWalletRequest, type CreateWebhookRequest, type DataViewColumn, type DataViewComputation, type DataViewDetail, type DataViewExecuteResult, type DataViewInfo, type DataViewListResponse, type DataViewPreviewRequest, type DataViewPreviewResult, type DataViewSummary, DataViewsClient, DocumentsResource, type DualWallets, type EarnedReward, type EndUser, type EndUserListResponse, EndUsersClient, type Event, type EventBatchProof, type EventMetadata, type EventStatus, EventsResource, type ExecuteSwapRequest, type Facet, type FacetsResponse, type FanProfileView, type FieldValue, type IngestEventRequest, type IngestEventResponse, IngestionClient, type IngestionClientOptions, type IssueCertificateRequest, type LinkWalletRequest, type ListCertificatesRequest, type ListEndUsersOptions, type ListEventsRequest, type ListQuestsOptions, type ListRewardsOptions, type ListSchemasOptions, type ManualRewardRequest, type MergeUsersRequest, type Milestone, type NFT, NetworkError, NotFoundError, type Passport, PassportClient, type PassportDefinition, type PassportFieldValue, type PassportHistory, type PassportTemplate, type PassportV2Data, type PassportWithFields, ProofChain, ProofChainError, type ProofChainOptions, type ProofVerifyResult, type Quest, type QuestStep, type QuestWithProgress, QuestsClient, RateLimitError, type RewardAsset, type RewardDefinition, type RewardEarned, RewardsClient, type Schema, type SchemaDetail, type SchemaField, type SchemaListResponse, type ValidationError$1 as SchemaValidationError, SchemasClient, type SearchFilters, type SearchQueryRequest, type SearchRequest, SearchResource, type SearchResponse, type SearchResult, type SearchStats, ServerError, type Settlement, type StepCompletionResult, type StepProgress, type StreamAck, type StreamEventRequest, type SwapQuote, type SwapQuoteRequest, type SwapResult, type TemplateField, type TenantInfo, TenantResource, type TierDefinition, TimeoutError, type TokenBalance, type TransferRequest, type TransferResult, type UpdateDataViewRequest, type UpdateEndUserRequest, type UpdatePassportRequest, type UpdateWebhookRequest, type UsageStats, type UserAchievement, type UserActivity, type UserActivityResponse, type UserBadge, type UserQuestProgress, type UserWalletSummary, type UserWithWallets, type UsersWithWalletsResponse, type ValidateDataRequest, ValidationError, type ValidationErrorDetail, type ValidationResult, type VaultFile, type VaultFolder, type VaultListResponse, VaultResource, type VaultStats, type VaultUploadRequest, type VerificationResult, VerifyResource, type ViewColumn, type ViewTemplate, type Wallet, type WalletBalance, WalletClient, type WalletStats, type Webhook, WebhooksResource };

package/dist/index.d.ts

@@ -1007,13 +1007,6 @@ interface WalletBalance {
     network: string;
     balances: TokenBalance[];
 }
-interface TokenBalance {
-    token: string;
-    symbol: string;
-    balance: string;
-    decimals: number;
-    usd_value?: number;
-}
 interface NFT {
     id: string;
     wallet_id: string;
@@ -1157,11 +1150,20 @@ interface AddNFTRequest {
     source?: string;
 }
 interface TransferRequest {
-    from_address: string;
+    /** Source wallet address (required if wallet_id not provided) */
+    from_address?: string;
+    /** Source wallet ID (alternative to from_address) */
+    wallet_id?: string;
+    /** Destination address */
     to_address: string;
+    /** Amount to transfer (in token units, e.g., "0.1" for 0.1 ETH) */
     amount: string;
+    /** Token symbol (default: "ETH") */
     token?: string;
+    /** Network (default: "base-sepolia") */
     network?: string;
+    /** Contract address for custom ERC-20 tokens */
+    contract_address?: string;
 }
 interface TransferResult {
     tx_hash: string;
@@ -1169,9 +1171,80 @@ interface TransferResult {
     to: string;
     amount: string;
     token: string;
+    contract_address?: string;
     network: string;
     status: string;
 }
+interface Token {
+    id: string;
+    contract_address: string;
+    network: string;
+    symbol: string;
+    name: string;
+    decimals: number;
+    logo_url?: string;
+    color?: string;
+    coingecko_id?: string;
+    coinmarketcap_id?: string;
+    token_standard: string;
+    is_native_wrapper: boolean;
+    is_verified: boolean;
+    is_active: boolean;
+    is_hidden?: boolean;
+    display_order: number;
+    is_global: boolean;
+}
+interface CreateTokenRequest {
+    contract_address: string;
+    network: string;
+    symbol: string;
+    name: string;
+    decimals?: number;
+    logo_url?: string;
+    color?: string;
+    coingecko_id?: string;
+    coinmarketcap_id?: string;
+    custom_price_feed_url?: string;
+    is_native_wrapper?: boolean;
+    display_order?: number;
+}
+interface UpdateTokenRequest {
+    symbol?: string;
+    name?: string;
+    decimals?: number;
+    logo_url?: string;
+    color?: string;
+    coingecko_id?: string;
+    coinmarketcap_id?: string;
+    custom_price_feed_url?: string;
+    is_active?: boolean;
+    is_hidden?: boolean;
+    display_order?: number;
+}
+interface TokenBalance {
+    token: string;
+    symbol: string;
+    balance: string;
+    decimals: number;
+    usd_value?: number;
+}
+interface TokenBalance {
+    token: string;
+    balance: string;
+    raw_balance?: string;
+    contract_address?: string;
+    decimals: number;
+    name?: string;
+    logo_url?: string;
+    source: 'cdp' | 'custom' | 'global';
+}
+interface WalletBalanceResponse {
+    address: string;
+    network: string;
+    native_balance: string;
+    native_symbol: string;
+    balances: TokenBalance[];
+}
 interface UserWithWallets {
     user_id: string;
     wallets: Array<{
@@ -1225,9 +1298,11 @@ declare class WalletClient {
      */
     createDualBulk(userIds: string[], network?: string): Promise<DualWallets[]>;
     /**
-     * Get wallet balance
+     * Get wallet balance including custom tokens.
+     *
+     * Returns native balance (ETH) plus all registered token balances.
      */
-    getBalance(walletId: string): Promise<WalletBalance>;
+    getBalance(walletId: string): Promise<WalletBalanceResponse>;
     /**
      * Get comprehensive wallet information in a single call.
      *
@@ -1265,21 +1340,33 @@ declare class WalletClient {
         warning: string;
     }>;
     /**
-     * Transfer tokens from one address to another.
+     * Transfer tokens from a CDP wallet to any address.
+     *
+     * Supports native ETH and ERC-20 tokens. The source wallet must be a CDP-managed wallet.
      *
-     * @param request - Transfer details
+     * @param request - Transfer details (use wallet_id or from_address)
      * @returns Transaction result with hash and status
      *
      * @example
      * ```typescript
+     * // Transfer ETH using wallet_id
      * const result = await client.wallets.transfer({
-     *   from_address: '0x123...',
+     *   wallet_id: 'd1096269-f986-4fa6-a1f5-1a29ef69f6e4',
      *   to_address: '0x456...',
-     *   amount: '0.1',
+     *   amount: '0.0001',
      *   token: 'ETH',
-     *   network: 'base-sepolia',
+     *   network: 'base-mainnet',
      * });
      * console.log('TX Hash:', result.tx_hash);
+     *
+     * // Transfer using from_address
+     * const result2 = await client.wallets.transfer({
+     *   from_address: '0xaA2e82E5fCF97003d409Bc90826F40cfc8F27510',
+     *   to_address: '0x456...',
+     *   amount: '0.0001',
+     *   token: 'ETH',
+     *   network: 'base-mainnet',
+     * });
      * ```
      */
     transfer(request: TransferRequest): Promise<TransferResult>;
@@ -1318,6 +1405,63 @@ declare class WalletClient {
         limit?: number;
         offset?: number;
     }): Promise<TransactionHistory>;
+    /**
+     * Register a custom token for the tenant.
+     *
+     * This allows tracking balances and enabling transfers for custom ERC-20 tokens.
+     *
+     * @param request - Token details including contract address, symbol, decimals
+     * @returns The created token
+     *
+     * @example
+     * ```typescript
+     * const token = await client.wallets.createToken({
+     *   contract_address: '0x...',
+     *   network: 'base-mainnet',
+     *   symbol: 'wSOL',
+     *   name: 'Wrapped Solana',
+     *   decimals: 9,
+     * });
+     * ```
+     */
+    createToken(request: CreateTokenRequest): Promise<Token>;
+    /**
+     * List all tokens available to the tenant.
+     *
+     * Returns both tenant-specific tokens and global tokens.
+     *
+     * @param options - Filter options
+     */
+    listTokens(options?: {
+        network?: string;
+        include_global?: boolean;
+        include_hidden?: boolean;
+    }): Promise<Token[]>;
+    /**
+     * List global tokens (available to all tenants).
+     *
+     * These are well-known tokens like USDC, WETH, DAI, etc.
+     */
+    listGlobalTokens(network?: string): Promise<Token[]>;
+    /**
+     * Get a specific token by ID.
+     */
+    getToken(tokenId: string): Promise<Token>;
+    /**
+     * Get a token by contract address and network.
+     */
+    getTokenByContract(contractAddress: string, network: string): Promise<Token>;
+    /**
+     * Update a custom token.
+     */
+    updateToken(tokenId: string, request: UpdateTokenRequest): Promise<Token>;
+    /**
+     * Delete a custom token (soft delete).
+     */
+    deleteToken(tokenId: string): Promise<{
+        message: string;
+        token_id: string;
+    }>;
 }
 
 /**
@@ -1714,15 +1858,27 @@ interface UserQuestProgress {
     user_id: string;
     quest_id: string;
     quest_name: string;
-    status: 'not_started' | 'in_progress' | 'completed' | 'failed' | 'expired';
+    status: 'not_started' | 'in_progress' | 'completed' | 'failed' | 'expired' | 'reward_pending';
     started_at?: string;
     completed_at?: string;
     expires_at?: string;
     completion_count: number;
     current_step_order: number;
+    steps_completed: number;
+    total_steps: number;
+    completion_percentage: number;
     step_progress: StepProgress[];
     points_earned: number;
-    reward_earned: boolean;
+    reward_earned?: RewardEarned;
+}
+interface RewardEarned {
+    id: string;
+    reward_name: string;
+    reward_type: string;
+    value?: number;
+    value_currency?: string;
+    status: string;
+    earned_at: string;
 }
 interface StepProgress {
     step_id: string;
@@ -1732,6 +1888,14 @@ interface StepProgress {
     completed_at?: string;
     event_id?: string;
 }
+interface StepCompletionResult {
+    step_index: number;
+    step_completed: boolean;
+    quest_completed: boolean;
+    current_count: number;
+    target_count: number;
+    points_earned: number;
+}
 interface QuestWithProgress extends Quest {
     user_progress?: UserQuestProgress;
 }
@@ -1794,6 +1958,13 @@ declare class QuestsClient {
      * Get a quest by ID
      */
     get(questId: string): Promise<Quest>;
+    /**
+     * List available quests for a user (active, public quests with user progress)
+     * This is the main endpoint for frontend quest displays
+     */
+    listAvailable(userId: string, options?: {
+        category?: string;
+    }): Promise<QuestWithProgress[]>;
     /**
      * Get a quest by slug
      */
@@ -1811,7 +1982,11 @@ declare class QuestsClient {
      */
     delete(questId: string): Promise<void>;
     /**
-     * Activate a quest
+     * Publish/activate a quest (changes status from draft to active)
+     */
+    publish(questId: string): Promise<Quest>;
+    /**
+     * @deprecated Use publish() instead
      */
     activate(questId: string): Promise<Quest>;
     /**
@@ -1839,9 +2014,9 @@ declare class QuestsClient {
      */
     getUserProgress(questId: string, userId: string): Promise<UserQuestProgress>;
     /**
-     * Complete a step manually
+     * Complete a step manually by step index
      */
-    completeStep(questId: string, userId: string, stepId: string): Promise<UserQuestProgress>;
+    completeStep(questId: string, userId: string, stepIndex: number): Promise<StepCompletionResult>;
     /**
      * Get all quest progress for a user
      */
@@ -2609,4 +2784,4 @@ declare class TimeoutError extends ProofChainError {
     constructor(message?: string);
 }
 
-export { type Achievement, type ActivitySummaryView, type AddNFTRequest, type ApiKey, type AttestRequest, type AttestationMode, type AttestationResult, AuthenticationError, AuthorizationError, type AvailableView, type Badge, type BatchIngestRequest, type BatchIngestResponse, type BatchVerifyResult, type BlockchainProof, type BlockchainStats, type Certificate, type CertificateVerifyResult, CertificatesResource, type Channel, type ChannelState, type ChannelStatus, ChannelsResource, type ComprehensiveWalletInfo, type CreateAchievementRequest, type CreateApiKeyRequest, type CreateBadgeRequest, type CreateChannelRequest, type CreateDataViewRequest, type CreateDualWalletsRequest, type CreateEndUserRequest, type CreateEventRequest, type CreatePassportDefinitionRequest, type CreatePassportRequest, type CreateQuestRequest, type CreateQuestStepRequest, type CreateRewardDefinitionRequest, type CreateSchemaRequest, type CreateTemplateFieldRequest, type CreateTemplateRequest, type CreateWalletRequest, type CreateWebhookRequest, type DataViewColumn, type DataViewComputation, type DataViewDetail, type DataViewExecuteResult, type DataViewInfo, type DataViewListResponse, type DataViewPreviewRequest, type DataViewPreviewResult, type DataViewSummary, DataViewsClient, DocumentsResource, type DualWallets, type EarnedReward, type EndUser, type EndUserListResponse, EndUsersClient, type Event, type EventBatchProof, type EventMetadata, type EventStatus, EventsResource, type ExecuteSwapRequest, type Facet, type FacetsResponse, type FanProfileView, type FieldValue, type IngestEventRequest, type IngestEventResponse, IngestionClient, type IngestionClientOptions, type IssueCertificateRequest, type LinkWalletRequest, type ListCertificatesRequest, type ListEndUsersOptions, type ListEventsRequest, type ListQuestsOptions, type ListRewardsOptions, type ListSchemasOptions, type ManualRewardRequest, type MergeUsersRequest, type Milestone, type NFT, NetworkError, NotFoundError, type Passport, PassportClient, type PassportDefinition, type PassportFieldValue, type PassportHistory, type PassportTemplate, type PassportV2Data, type PassportWithFields, ProofChain, ProofChainError, type ProofChainOptions, type ProofVerifyResult, type Quest, type QuestStep, type QuestWithProgress, QuestsClient, RateLimitError, type RewardAsset, type RewardDefinition, RewardsClient, type Schema, type SchemaDetail, type SchemaField, type SchemaListResponse, type ValidationError$1 as SchemaValidationError, SchemasClient, type SearchFilters, type SearchQueryRequest, type SearchRequest, SearchResource, type SearchResponse, type SearchResult, type SearchStats, ServerError, type Settlement, type StepProgress, type StreamAck, type StreamEventRequest, type SwapQuote, type SwapQuoteRequest, type SwapResult, type TemplateField, type TenantInfo, TenantResource, type TierDefinition, TimeoutError, type TokenBalance, type TransferRequest, type TransferResult, type UpdateDataViewRequest, type UpdateEndUserRequest, type UpdatePassportRequest, type UpdateWebhookRequest, type UsageStats, type UserAchievement, type UserActivity, type UserActivityResponse, type UserBadge, type UserQuestProgress, type UserWalletSummary, type UserWithWallets, type UsersWithWalletsResponse, type ValidateDataRequest, ValidationError, type ValidationErrorDetail, type ValidationResult, type VaultFile, type VaultFolder, type VaultListResponse, VaultResource, type VaultStats, type VaultUploadRequest, type VerificationResult, VerifyResource, type ViewColumn, type ViewTemplate, type Wallet, type WalletBalance, WalletClient, type WalletStats, type Webhook, WebhooksResource };
+export { type Achievement, type ActivitySummaryView, type AddNFTRequest, type ApiKey, type AttestRequest, type AttestationMode, type AttestationResult, AuthenticationError, AuthorizationError, type AvailableView, type Badge, type BatchIngestRequest, type BatchIngestResponse, type BatchVerifyResult, type BlockchainProof, type BlockchainStats, type Certificate, type CertificateVerifyResult, CertificatesResource, type Channel, type ChannelState, type ChannelStatus, ChannelsResource, type ComprehensiveWalletInfo, type CreateAchievementRequest, type CreateApiKeyRequest, type CreateBadgeRequest, type CreateChannelRequest, type CreateDataViewRequest, type CreateDualWalletsRequest, type CreateEndUserRequest, type CreateEventRequest, type CreatePassportDefinitionRequest, type CreatePassportRequest, type CreateQuestRequest, type CreateQuestStepRequest, type CreateRewardDefinitionRequest, type CreateSchemaRequest, type CreateTemplateFieldRequest, type CreateTemplateRequest, type CreateWalletRequest, type CreateWebhookRequest, type DataViewColumn, type DataViewComputation, type DataViewDetail, type DataViewExecuteResult, type DataViewInfo, type DataViewListResponse, type DataViewPreviewRequest, type DataViewPreviewResult, type DataViewSummary, DataViewsClient, DocumentsResource, type DualWallets, type EarnedReward, type EndUser, type EndUserListResponse, EndUsersClient, type Event, type EventBatchProof, type EventMetadata, type EventStatus, EventsResource, type ExecuteSwapRequest, type Facet, type FacetsResponse, type FanProfileView, type FieldValue, type IngestEventRequest, type IngestEventResponse, IngestionClient, type IngestionClientOptions, type IssueCertificateRequest, type LinkWalletRequest, type ListCertificatesRequest, type ListEndUsersOptions, type ListEventsRequest, type ListQuestsOptions, type ListRewardsOptions, type ListSchemasOptions, type ManualRewardRequest, type MergeUsersRequest, type Milestone, type NFT, NetworkError, NotFoundError, type Passport, PassportClient, type PassportDefinition, type PassportFieldValue, type PassportHistory, type PassportTemplate, type PassportV2Data, type PassportWithFields, ProofChain, ProofChainError, type ProofChainOptions, type ProofVerifyResult, type Quest, type QuestStep, type QuestWithProgress, QuestsClient, RateLimitError, type RewardAsset, type RewardDefinition, type RewardEarned, RewardsClient, type Schema, type SchemaDetail, type SchemaField, type SchemaListResponse, type ValidationError$1 as SchemaValidationError, SchemasClient, type SearchFilters, type SearchQueryRequest, type SearchRequest, SearchResource, type SearchResponse, type SearchResult, type SearchStats, ServerError, type Settlement, type StepCompletionResult, type StepProgress, type StreamAck, type StreamEventRequest, type SwapQuote, type SwapQuoteRequest, type SwapResult, type TemplateField, type TenantInfo, TenantResource, type TierDefinition, TimeoutError, type TokenBalance, type TransferRequest, type TransferResult, type UpdateDataViewRequest, type UpdateEndUserRequest, type UpdatePassportRequest, type UpdateWebhookRequest, type UsageStats, type UserAchievement, type UserActivity, type UserActivityResponse, type UserBadge, type UserQuestProgress, type UserWalletSummary, type UserWithWallets, type UsersWithWalletsResponse, type ValidateDataRequest, ValidationError, type ValidationErrorDetail, type ValidationResult, type VaultFile, type VaultFolder, type VaultListResponse, VaultResource, type VaultStats, type VaultUploadRequest, type VerificationResult, VerifyResource, type ViewColumn, type ViewTemplate, type Wallet, type WalletBalance, WalletClient, type WalletStats, type Webhook, WebhooksResource };

package/dist/index.js

@@ -887,7 +887,9 @@ var WalletClient = class {
   // Balances
   // ---------------------------------------------------------------------------
   /**
-   * Get wallet balance
+   * Get wallet balance including custom tokens.
+   * 
+   * Returns native balance (ETH) plus all registered token balances.
    */
   async getBalance(walletId) {
     return this.http.get(`/wallets/${walletId}/balance`);
@@ -951,21 +953,33 @@ var WalletClient = class {
   // Token Transfers
   // ---------------------------------------------------------------------------
   /**
-   * Transfer tokens from one address to another.
+   * Transfer tokens from a CDP wallet to any address.
+   * 
+   * Supports native ETH and ERC-20 tokens. The source wallet must be a CDP-managed wallet.
    * 
-   * @param request - Transfer details
+   * @param request - Transfer details (use wallet_id or from_address)
    * @returns Transaction result with hash and status
    * 
    * @example
    * ```typescript
+   * // Transfer ETH using wallet_id
    * const result = await client.wallets.transfer({
-   *   from_address: '0x123...',
+   *   wallet_id: 'd1096269-f986-4fa6-a1f5-1a29ef69f6e4',
    *   to_address: '0x456...',
-   *   amount: '0.1',
+   *   amount: '0.0001',
    *   token: 'ETH',
-   *   network: 'base-sepolia',
+   *   network: 'base-mainnet',
    * });
    * console.log('TX Hash:', result.tx_hash);
+   * 
+   * // Transfer using from_address
+   * const result2 = await client.wallets.transfer({
+   *   from_address: '0xaA2e82E5fCF97003d409Bc90826F40cfc8F27510',
+   *   to_address: '0x456...',
+   *   amount: '0.0001',
+   *   token: 'ETH',
+   *   network: 'base-mainnet',
+   * });
    * ```
    */
   async transfer(request) {
@@ -1034,6 +1048,81 @@ var WalletClient = class {
       `/wallets/${walletId}/transactions${query ? `?${query}` : ""}`
     );
   }
+  // ---------------------------------------------------------------------------
+  // Token Management
+  // ---------------------------------------------------------------------------
+  /**
+   * Register a custom token for the tenant.
+   * 
+   * This allows tracking balances and enabling transfers for custom ERC-20 tokens.
+   * 
+   * @param request - Token details including contract address, symbol, decimals
+   * @returns The created token
+   * 
+   * @example
+   * ```typescript
+   * const token = await client.wallets.createToken({
+   *   contract_address: '0x...',
+   *   network: 'base-mainnet',
+   *   symbol: 'wSOL',
+   *   name: 'Wrapped Solana',
+   *   decimals: 9,
+   * });
+   * ```
+   */
+  async createToken(request) {
+    return this.http.post("/tokens", request);
+  }
+  /**
+   * List all tokens available to the tenant.
+   * 
+   * Returns both tenant-specific tokens and global tokens.
+   * 
+   * @param options - Filter options
+   */
+  async listTokens(options = {}) {
+    const params = new URLSearchParams();
+    if (options.network) params.set("network", options.network);
+    if (options.include_global !== void 0) params.set("include_global", String(options.include_global));
+    if (options.include_hidden !== void 0) params.set("include_hidden", String(options.include_hidden));
+    const query = params.toString();
+    return this.http.get(`/tokens${query ? `?${query}` : ""}`);
+  }
+  /**
+   * List global tokens (available to all tenants).
+   * 
+   * These are well-known tokens like USDC, WETH, DAI, etc.
+   */
+  async listGlobalTokens(network) {
+    const params = network ? `?network=${network}` : "";
+    return this.http.get(`/tokens/global${params}`);
+  }
+  /**
+   * Get a specific token by ID.
+   */
+  async getToken(tokenId) {
+    return this.http.get(`/tokens/${tokenId}`);
+  }
+  /**
+   * Get a token by contract address and network.
+   */
+  async getTokenByContract(contractAddress, network) {
+    return this.http.get(
+      `/tokens/by-contract/${contractAddress}?network=${encodeURIComponent(network)}`
+    );
+  }
+  /**
+   * Update a custom token.
+   */
+  async updateToken(tokenId, request) {
+    return this.http.patch(`/tokens/${tokenId}`, request);
+  }
+  /**
+   * Delete a custom token (soft delete).
+   */
+  async deleteToken(tokenId) {
+    return this.http.delete(`/tokens/${tokenId}`);
+  }
 };
 
 // src/users.ts
@@ -1282,6 +1371,16 @@ var QuestsClient = class {
   async get(questId) {
     return this.http.get(`/quests/${questId}`);
   }
+  /**
+   * List available quests for a user (active, public quests with user progress)
+   * This is the main endpoint for frontend quest displays
+   */
+  async listAvailable(userId, options = {}) {
+    const params = new URLSearchParams();
+    params.append("user_id", userId);
+    if (options.category) params.append("category", options.category);
+    return this.http.get(`/quests/available?${params.toString()}`);
+  }
   /**
    * Get a quest by slug
    */
@@ -1310,10 +1409,16 @@ var QuestsClient = class {
   // Quest Status
   // ---------------------------------------------------------------------------
   /**
-   * Activate a quest
+   * Publish/activate a quest (changes status from draft to active)
+   */
+  async publish(questId) {
+    return this.http.post(`/quests/${questId}/publish`, {});
+  }
+  /**
+   * @deprecated Use publish() instead
    */
   async activate(questId) {
-    return this.http.post(`/quests/${questId}/activate`, {});
+    return this.publish(questId);
   }
   /**
    * Pause a quest
@@ -1359,12 +1464,13 @@ var QuestsClient = class {
     return this.http.get(`/quests/${questId}/progress/${encodeURIComponent(userId)}`);
   }
   /**
-   * Complete a step manually
+   * Complete a step manually by step index
    */
-  async completeStep(questId, userId, stepId) {
-    return this.http.post(`/quests/${questId}/steps/${stepId}/complete`, {
-      user_id: userId
-    });
+  async completeStep(questId, userId, stepIndex) {
+    return this.http.post(
+      `/quests/${questId}/progress/${encodeURIComponent(userId)}/step/${stepIndex}/complete`,
+      {}
+    );
   }
   /**
    * Get all quest progress for a user

package/dist/index.mjs

@@ -835,7 +835,9 @@ var WalletClient = class {
   // Balances
   // ---------------------------------------------------------------------------
   /**
-   * Get wallet balance
+   * Get wallet balance including custom tokens.
+   * 
+   * Returns native balance (ETH) plus all registered token balances.
    */
   async getBalance(walletId) {
     return this.http.get(`/wallets/${walletId}/balance`);
@@ -899,21 +901,33 @@ var WalletClient = class {
   // Token Transfers
   // ---------------------------------------------------------------------------
   /**
-   * Transfer tokens from one address to another.
+   * Transfer tokens from a CDP wallet to any address.
+   * 
+   * Supports native ETH and ERC-20 tokens. The source wallet must be a CDP-managed wallet.
    * 
-   * @param request - Transfer details
+   * @param request - Transfer details (use wallet_id or from_address)
    * @returns Transaction result with hash and status
    * 
    * @example
    * ```typescript
+   * // Transfer ETH using wallet_id
    * const result = await client.wallets.transfer({
-   *   from_address: '0x123...',
+   *   wallet_id: 'd1096269-f986-4fa6-a1f5-1a29ef69f6e4',
    *   to_address: '0x456...',
-   *   amount: '0.1',
+   *   amount: '0.0001',
    *   token: 'ETH',
-   *   network: 'base-sepolia',
+   *   network: 'base-mainnet',
    * });
    * console.log('TX Hash:', result.tx_hash);
+   * 
+   * // Transfer using from_address
+   * const result2 = await client.wallets.transfer({
+   *   from_address: '0xaA2e82E5fCF97003d409Bc90826F40cfc8F27510',
+   *   to_address: '0x456...',
+   *   amount: '0.0001',
+   *   token: 'ETH',
+   *   network: 'base-mainnet',
+   * });
    * ```
    */
   async transfer(request) {
@@ -982,6 +996,81 @@ var WalletClient = class {
       `/wallets/${walletId}/transactions${query ? `?${query}` : ""}`
     );
   }
+  // ---------------------------------------------------------------------------
+  // Token Management
+  // ---------------------------------------------------------------------------
+  /**
+   * Register a custom token for the tenant.
+   * 
+   * This allows tracking balances and enabling transfers for custom ERC-20 tokens.
+   * 
+   * @param request - Token details including contract address, symbol, decimals
+   * @returns The created token
+   * 
+   * @example
+   * ```typescript
+   * const token = await client.wallets.createToken({
+   *   contract_address: '0x...',
+   *   network: 'base-mainnet',
+   *   symbol: 'wSOL',
+   *   name: 'Wrapped Solana',
+   *   decimals: 9,
+   * });
+   * ```
+   */
+  async createToken(request) {
+    return this.http.post("/tokens", request);
+  }
+  /**
+   * List all tokens available to the tenant.
+   * 
+   * Returns both tenant-specific tokens and global tokens.
+   * 
+   * @param options - Filter options
+   */
+  async listTokens(options = {}) {
+    const params = new URLSearchParams();
+    if (options.network) params.set("network", options.network);
+    if (options.include_global !== void 0) params.set("include_global", String(options.include_global));
+    if (options.include_hidden !== void 0) params.set("include_hidden", String(options.include_hidden));
+    const query = params.toString();
+    return this.http.get(`/tokens${query ? `?${query}` : ""}`);
+  }
+  /**
+   * List global tokens (available to all tenants).
+   * 
+   * These are well-known tokens like USDC, WETH, DAI, etc.
+   */
+  async listGlobalTokens(network) {
+    const params = network ? `?network=${network}` : "";
+    return this.http.get(`/tokens/global${params}`);
+  }
+  /**
+   * Get a specific token by ID.
+   */
+  async getToken(tokenId) {
+    return this.http.get(`/tokens/${tokenId}`);
+  }
+  /**
+   * Get a token by contract address and network.
+   */
+  async getTokenByContract(contractAddress, network) {
+    return this.http.get(
+      `/tokens/by-contract/${contractAddress}?network=${encodeURIComponent(network)}`
+    );
+  }
+  /**
+   * Update a custom token.
+   */
+  async updateToken(tokenId, request) {
+    return this.http.patch(`/tokens/${tokenId}`, request);
+  }
+  /**
+   * Delete a custom token (soft delete).
+   */
+  async deleteToken(tokenId) {
+    return this.http.delete(`/tokens/${tokenId}`);
+  }
 };
 
 // src/users.ts
@@ -1230,6 +1319,16 @@ var QuestsClient = class {
   async get(questId) {
     return this.http.get(`/quests/${questId}`);
   }
+  /**
+   * List available quests for a user (active, public quests with user progress)
+   * This is the main endpoint for frontend quest displays
+   */
+  async listAvailable(userId, options = {}) {
+    const params = new URLSearchParams();
+    params.append("user_id", userId);
+    if (options.category) params.append("category", options.category);
+    return this.http.get(`/quests/available?${params.toString()}`);
+  }
   /**
    * Get a quest by slug
    */
@@ -1258,10 +1357,16 @@ var QuestsClient = class {
   // Quest Status
   // ---------------------------------------------------------------------------
   /**
-   * Activate a quest
+   * Publish/activate a quest (changes status from draft to active)
+   */
+  async publish(questId) {
+    return this.http.post(`/quests/${questId}/publish`, {});
+  }
+  /**
+   * @deprecated Use publish() instead
    */
   async activate(questId) {
-    return this.http.post(`/quests/${questId}/activate`, {});
+    return this.publish(questId);
   }
   /**
    * Pause a quest
@@ -1307,12 +1412,13 @@ var QuestsClient = class {
     return this.http.get(`/quests/${questId}/progress/${encodeURIComponent(userId)}`);
   }
   /**
-   * Complete a step manually
+   * Complete a step manually by step index
    */
-  async completeStep(questId, userId, stepId) {
-    return this.http.post(`/quests/${questId}/steps/${stepId}/complete`, {
-      user_id: userId
-    });
+  async completeStep(questId, userId, stepIndex) {
+    return this.http.post(
+      `/quests/${questId}/progress/${encodeURIComponent(userId)}/step/${stepIndex}/complete`,
+      {}
+    );
   }
   /**
    * Get all quest progress for a user

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@proofchain/sdk",
-  "version": "2.1.1",
+  "version": "2.3.0",
   "description": "Official JavaScript/TypeScript SDK for ProofChain - blockchain-anchored document attestation",
   "main": "dist/index.js",
   "module": "dist/index.mjs",