@proofchain/sdk 2.0.0 → 2.1.1

package/dist/index.d.mts

@@ -1051,6 +1051,25 @@ interface WalletStats {
     by_type: Record<string, number>;
     by_network: Record<string, number>;
 }
+interface Transaction {
+    hash: string;
+    type: 'sent' | 'received';
+    from: string;
+    to: string;
+    value: number | string;
+    asset: string;
+    category: string;
+    block_num: string;
+    timestamp: string;
+}
+interface TransactionHistory {
+    address: string;
+    network: string;
+    total_sent: number;
+    total_received: number;
+    transactions: Transaction[];
+    error?: string;
+}
 interface ComprehensiveWalletInfo {
     wallet_id: string;
     address: string;
@@ -1153,6 +1172,23 @@ interface TransferResult {
     network: string;
     status: string;
 }
+interface UserWithWallets {
+    user_id: string;
+    wallets: Array<{
+        wallet_id: string;
+        address: string;
+        wallet_type: string;
+        network: string;
+        name?: string;
+        status: string;
+    }>;
+}
+interface UsersWithWalletsResponse {
+    users: UserWithWallets[];
+    total: number;
+    limit: number;
+    offset: number;
+}
 declare class WalletClient {
     private http;
     constructor(http: HttpClient);
@@ -1172,6 +1208,14 @@ declare class WalletClient {
      * Get wallet statistics
      */
     stats(): Promise<WalletStats>;
+    /**
+     * List all users who have wallets, grouped by user_id.
+     *
+     * @param limit - Maximum number of users to return (default 50)
+     * @param offset - Offset for pagination (default 0)
+     * @returns List of users with their wallets
+     */
+    listUsersWithWallets(limit?: number, offset?: number): Promise<UsersWithWalletsResponse>;
     /**
      * Create dual wallets (EOA asset wallet + Smart Account) for a user
      */
@@ -1259,6 +1303,21 @@ declare class WalletClient {
      * Add an NFT to wallet tracking
      */
     addNFT(walletId: string, nft: AddNFTRequest): Promise<NFT>;
+    /**
+     * Get transaction history for a wallet.
+     *
+     * Returns both sent and received transactions including:
+     * - Token transfers (ETH, ERC20)
+     * - NFT transfers
+     * - Contract interactions
+     *
+     * @param walletId - Wallet ID to query
+     * @param options - Pagination options
+     */
+    getTransactions(walletId: string, options?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<TransactionHistory>;
 }
 
 /**
@@ -2550,4 +2609,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 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, 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 };

package/dist/index.d.ts

@@ -1051,6 +1051,25 @@ interface WalletStats {
     by_type: Record<string, number>;
     by_network: Record<string, number>;
 }
+interface Transaction {
+    hash: string;
+    type: 'sent' | 'received';
+    from: string;
+    to: string;
+    value: number | string;
+    asset: string;
+    category: string;
+    block_num: string;
+    timestamp: string;
+}
+interface TransactionHistory {
+    address: string;
+    network: string;
+    total_sent: number;
+    total_received: number;
+    transactions: Transaction[];
+    error?: string;
+}
 interface ComprehensiveWalletInfo {
     wallet_id: string;
     address: string;
@@ -1153,6 +1172,23 @@ interface TransferResult {
     network: string;
     status: string;
 }
+interface UserWithWallets {
+    user_id: string;
+    wallets: Array<{
+        wallet_id: string;
+        address: string;
+        wallet_type: string;
+        network: string;
+        name?: string;
+        status: string;
+    }>;
+}
+interface UsersWithWalletsResponse {
+    users: UserWithWallets[];
+    total: number;
+    limit: number;
+    offset: number;
+}
 declare class WalletClient {
     private http;
     constructor(http: HttpClient);
@@ -1172,6 +1208,14 @@ declare class WalletClient {
      * Get wallet statistics
      */
     stats(): Promise<WalletStats>;
+    /**
+     * List all users who have wallets, grouped by user_id.
+     *
+     * @param limit - Maximum number of users to return (default 50)
+     * @param offset - Offset for pagination (default 0)
+     * @returns List of users with their wallets
+     */
+    listUsersWithWallets(limit?: number, offset?: number): Promise<UsersWithWalletsResponse>;
     /**
      * Create dual wallets (EOA asset wallet + Smart Account) for a user
      */
@@ -1259,6 +1303,21 @@ declare class WalletClient {
      * Add an NFT to wallet tracking
      */
     addNFT(walletId: string, nft: AddNFTRequest): Promise<NFT>;
+    /**
+     * Get transaction history for a wallet.
+     *
+     * Returns both sent and received transactions including:
+     * - Token transfers (ETH, ERC20)
+     * - NFT transfers
+     * - Contract interactions
+     *
+     * @param walletId - Wallet ID to query
+     * @param options - Pagination options
+     */
+    getTransactions(walletId: string, options?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<TransactionHistory>;
 }
 
 /**
@@ -2550,4 +2609,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 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, 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 };

package/dist/index.js

@@ -855,6 +855,16 @@ var WalletClient = class {
   async stats() {
     return this.http.get("/wallets/stats");
   }
+  /**
+   * List all users who have wallets, grouped by user_id.
+   * 
+   * @param limit - Maximum number of users to return (default 50)
+   * @param offset - Offset for pagination (default 0)
+   * @returns List of users with their wallets
+   */
+  async listUsersWithWallets(limit = 50, offset = 0) {
+    return this.http.get(`/wallets/users-with-wallets?limit=${limit}&offset=${offset}`);
+  }
   // ---------------------------------------------------------------------------
   // Dual Wallets (EOA + Smart Account)
   // ---------------------------------------------------------------------------
@@ -997,6 +1007,33 @@ var WalletClient = class {
   async addNFT(walletId, nft) {
     return this.http.post(`/wallets/${walletId}/nfts`, nft);
   }
+  // ---------------------------------------------------------------------------
+  // Transaction History
+  // ---------------------------------------------------------------------------
+  /**
+   * Get transaction history for a wallet.
+   * 
+   * Returns both sent and received transactions including:
+   * - Token transfers (ETH, ERC20)
+   * - NFT transfers
+   * - Contract interactions
+   * 
+   * @param walletId - Wallet ID to query
+   * @param options - Pagination options
+   */
+  async getTransactions(walletId, options = {}) {
+    const params = new URLSearchParams();
+    if (options.limit !== void 0) {
+      params.set("limit", String(options.limit));
+    }
+    if (options.offset !== void 0) {
+      params.set("offset", String(options.offset));
+    }
+    const query = params.toString();
+    return this.http.get(
+      `/wallets/${walletId}/transactions${query ? `?${query}` : ""}`
+    );
+  }
 };
 
 // src/users.ts

package/dist/index.mjs

@@ -803,6 +803,16 @@ var WalletClient = class {
   async stats() {
     return this.http.get("/wallets/stats");
   }
+  /**
+   * List all users who have wallets, grouped by user_id.
+   * 
+   * @param limit - Maximum number of users to return (default 50)
+   * @param offset - Offset for pagination (default 0)
+   * @returns List of users with their wallets
+   */
+  async listUsersWithWallets(limit = 50, offset = 0) {
+    return this.http.get(`/wallets/users-with-wallets?limit=${limit}&offset=${offset}`);
+  }
   // ---------------------------------------------------------------------------
   // Dual Wallets (EOA + Smart Account)
   // ---------------------------------------------------------------------------
@@ -945,6 +955,33 @@ var WalletClient = class {
   async addNFT(walletId, nft) {
     return this.http.post(`/wallets/${walletId}/nfts`, nft);
   }
+  // ---------------------------------------------------------------------------
+  // Transaction History
+  // ---------------------------------------------------------------------------
+  /**
+   * Get transaction history for a wallet.
+   * 
+   * Returns both sent and received transactions including:
+   * - Token transfers (ETH, ERC20)
+   * - NFT transfers
+   * - Contract interactions
+   * 
+   * @param walletId - Wallet ID to query
+   * @param options - Pagination options
+   */
+  async getTransactions(walletId, options = {}) {
+    const params = new URLSearchParams();
+    if (options.limit !== void 0) {
+      params.set("limit", String(options.limit));
+    }
+    if (options.offset !== void 0) {
+      params.set("offset", String(options.offset));
+    }
+    const query = params.toString();
+    return this.http.get(
+      `/wallets/${walletId}/transactions${query ? `?${query}` : ""}`
+    );
+  }
 };
 
 // src/users.ts

package/package.json

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