mmn-client-js 1.0.14-node14 → 1.0.14

package/dist/index.d.ts

@@ -1,285 +1,291 @@
-interface JsonRpcRequest {
-    jsonrpc: '2.0';
-    method: string;
-    params?: unknown;
-    id: string | number;
-}
-interface JsonRpcError {
-    code: number;
-    message: string;
-    data?: unknown;
-}
-interface JsonRpcResponse<T = unknown> {
-    jsonrpc: '2.0';
-    result?: T;
-    error?: JsonRpcError;
-    id: string | number;
-}
-interface IEphemeralKeyPair {
-    privateKey: string;
-    publicKey: string;
-}
-declare enum ETransferType {
-    GiveCoffee = "give_coffee",
-    TransferToken = "transfer_token",
-    UnlockItem = "unlock_item"
-}
-interface ExtraInfo {
-    type: ETransferType | string;
-    ItemId?: string;
-    ItemType?: string;
-    ClanId?: string;
-    UserSenderId?: string;
-    UserSenderUsername?: string;
-    UserReceiverId?: string;
-    ChannelId?: string;
-    MessageRefId?: string;
-    ExtraAttribute?: string;
-    [x: string]: string;
-}
-interface TxMsg {
-    type: number;
-    sender: string;
-    recipient: string;
-    amount: string;
-    timestamp: number;
-    text_data: string;
-    nonce: number;
-    extra_info: string;
-    zk_proof: string;
-    zk_pub: string;
-}
-interface SignedTx {
-    tx_msg: TxMsg;
-    signature: string;
-}
-interface SendTransactionBase {
-    sender: string;
-    recipient: string;
-    amount: string;
-    nonce: number;
-    timestamp?: number;
-    textData?: string;
-    privateKey: string;
-    extraInfo?: ExtraInfo;
-}
-interface SendTransactionRequest extends SendTransactionBase {
-    zkProof: string;
-    zkPub: string;
-    publicKey: string;
-}
-interface AddTxResponse {
-    ok: boolean;
-    tx_hash: string;
-    error: string;
-}
-interface GetCurrentNonceResponse {
-    address: string;
-    nonce: number;
-    tag: string;
-    error: string;
-}
-interface GetAccountByAddressResponse {
-    address: string;
-    balance: string;
-    nonce: number;
-    decimals: number;
-}
-interface MmnClientConfig {
-    baseUrl: string;
-    timeout?: number;
-    headers?: Record<string, string>;
-}
-interface Transaction {
-    chain_id: string;
-    hash: string;
-    nonce: number;
-    block_hash: string;
-    block_number: number;
-    block_timestamp: number;
-    transaction_index: number;
-    from_address: string;
-    to_address: string;
-    value: string;
-    gas: number;
-    gas_price: string;
-    data: string;
-    function_selector: string;
-    max_fee_per_gas: string;
-    max_priority_fee_per_gas: string;
-    max_fee_per_blob_gas?: string;
-    blob_versioned_hashes?: string[];
-    transaction_type: number;
-    r: string;
-    s: string;
-    v: string;
-    access_list_json?: string;
-    authorization_list_json?: string;
-    contract_address?: string;
-    gas_used?: number;
-    cumulative_gas_used?: number;
-    effective_gas_price?: string;
-    blob_gas_used?: number;
-    blob_gas_price?: string;
-    logs_bloom?: string;
-    status?: number;
-    transaction_timestamp: number;
-    text_data: string;
-    extra_info: string;
-}
-interface Meta {
-    chain_id: number;
-    address?: string;
-    signature?: string;
-    page: number;
-    limit?: number;
-    total_items?: number;
-    total_pages?: number;
-}
-interface WalletDetail {
-    address: string;
-    balance: string;
-    account_nonce: number;
-    last_balance_update: number;
-}
-interface WalletDetailResponse {
-    data: WalletDetail;
-}
-interface ListTransactionResponse {
-    meta: Meta;
-    data?: Transaction[];
-}
-interface TransactionDetailResponse {
-    data: {
-        transaction: Transaction;
-    };
-}
-interface IndexerClientConfig {
-    endpoint: string;
-    chainId: string;
-    timeout?: number;
-    headers?: Record<string, string>;
-}
-interface ZkClientConfig {
-    endpoint: string;
-    timeout?: number;
-    headers?: Record<string, string>;
-}
-declare enum EZkClientType {
-    MEZON = "mezon",
-    OAUTH = "oauth"
-}
-interface GetZkProofRequest {
-    userId: string;
-    ephemeralPublicKey: string;
-    jwt: string;
-    address: string;
-    clientType?: EZkClientType;
-}
-interface IZkProof {
-    proof: string;
-    public_input: string;
+interface JsonRpcRequest {
+    jsonrpc: '2.0';
+    method: string;
+    params?: unknown;
+    id: string | number;
+}
+interface JsonRpcError {
+    code: number;
+    message: string;
+    data?: unknown;
+}
+interface JsonRpcResponse<T = unknown> {
+    jsonrpc: '2.0';
+    result?: T;
+    error?: JsonRpcError;
+    id: string | number;
+}
+interface IEphemeralKeyPair {
+    privateKey: string;
+    publicKey: string;
+}
+declare enum ETransferType {
+    GiveCoffee = "give_coffee",
+    TransferToken = "transfer_token",
+    UnlockItem = "unlock_item"
+}
+interface ExtraInfo {
+    type: ETransferType | string;
+    ItemId?: string;
+    ItemType?: string;
+    ClanId?: string;
+    UserSenderId?: string;
+    UserSenderUsername?: string;
+    UserReceiverId?: string;
+    ChannelId?: string;
+    MessageRefId?: string;
+    ExtraAttribute?: string;
+    [x: string]: string | string[];
+}
+interface TxMsg {
+    type: number;
+    sender: string;
+    recipient: string;
+    amount: string;
+    timestamp: number;
+    text_data: string;
+    nonce: number;
+    extra_info: string;
+    zk_proof: string;
+    zk_pub: string;
+}
+interface SignedTx {
+    tx_msg: TxMsg;
+    signature: string;
+}
+interface SendTransactionBase {
+    sender: string;
+    recipient: string;
+    amount: string;
+    nonce: number;
+    timestamp?: number;
+    textData?: string;
+    privateKey: string;
+    extraInfo?: ExtraInfo;
+}
+interface SendTransactionRequest extends SendTransactionBase {
+    zkProof: string;
+    zkPub: string;
+    publicKey: string;
+}
+interface AddTxResponse {
+    ok: boolean;
+    tx_hash: string;
+    error: string;
+}
+interface GetCurrentNonceResponse {
+    address: string;
+    nonce: number;
+    tag: string;
+    error: string;
+}
+interface GetAccountByAddressResponse {
+    address: string;
+    balance: string;
+    nonce: number;
+    decimals: number;
+}
+interface MmnClientConfig {
+    baseUrl: string;
+    timeout?: number;
+    headers?: Record<string, string>;
+}
+interface Transaction {
+    chain_id: string;
+    hash: string;
+    nonce: number;
+    block_hash: string;
+    block_number: number;
+    block_timestamp: number;
+    transaction_index: number;
+    from_address: string;
+    to_address: string;
+    value: string;
+    gas: number;
+    gas_price: string;
+    data: string;
+    function_selector: string;
+    max_fee_per_gas: string;
+    max_priority_fee_per_gas: string;
+    max_fee_per_blob_gas?: string;
+    blob_versioned_hashes?: string[];
+    transaction_type: number;
+    r: string;
+    s: string;
+    v: string;
+    access_list_json?: string;
+    authorization_list_json?: string;
+    contract_address?: string;
+    gas_used?: number;
+    cumulative_gas_used?: number;
+    effective_gas_price?: string;
+    blob_gas_used?: number;
+    blob_gas_price?: string;
+    logs_bloom?: string;
+    status?: number;
+    transaction_timestamp: number;
+    text_data: string;
+    extra_info: string;
+}
+interface Meta {
+    chain_id: number;
+    address?: string;
+    signature?: string;
+    page: number;
+    limit?: number;
+    total_items?: number;
+    total_pages?: number;
+    has_more?: boolean;
+    next_timestamp?: string;
+    next_hash?: string;
+}
+interface WalletDetail {
+    address: string;
+    balance: string;
+    account_nonce: number;
+    last_balance_update: number;
+}
+interface WalletDetailResponse {
+    data: WalletDetail;
+}
+interface ListTransactionResponse {
+    meta: Meta;
+    data?: Transaction[];
+}
+interface TransactionDetailResponse {
+    data: {
+        transaction: Transaction;
+    };
+}
+interface IndexerClientConfig {
+    endpoint: string;
+    chainId: string;
+    timeout?: number;
+    headers?: Record<string, string>;
+}
+interface ZkClientConfig {
+    endpoint: string;
+    timeout?: number;
+    headers?: Record<string, string>;
+}
+declare enum EZkClientType {
+    MEZON = "mezon",
+    OAUTH = "oauth"
+}
+interface GetZkProofRequest {
+    userId: string;
+    ephemeralPublicKey: string;
+    jwt: string;
+    address: string;
+    clientType?: EZkClientType;
+}
+interface IZkProof {
+    proof: string;
+    public_input: string;
 }
 
-declare class IndexerClient {
-    private endpoint;
-    private chainId;
-    private timeout;
-    private headers;
-    constructor(config: IndexerClientConfig);
-    /**
-     * Make HTTP request with automatic CORS handling
-     * Works out-of-the-box without CORS configuration
-     * @param method - HTTP method (GET or POST)
-     * @param path - API endpoint path
-     * @param params - URL query parameters
-     * @param body - Request body for POST requests
-     * @returns Promise resolving to response data
-     */
-    private makeRequest;
-    getTransactionByHash(hash: string): Promise<Transaction>;
-    getTransactionByWallet(wallet: string, page: number | undefined, limit: number | undefined, filter: number, sortBy?: string, sortOrder?: 'asc' | 'desc'): Promise<ListTransactionResponse>;
-    getWalletDetail(wallet: string): Promise<WalletDetail>;
+declare class IndexerClient {
+    private endpoint;
+    private chainId;
+    private timeout;
+    private headers;
+    constructor(config: IndexerClientConfig);
+    /**
+     * Make HTTP request with automatic CORS handling
+     * Works out-of-the-box without CORS configuration
+     * @param method - HTTP method (GET or POST)
+     * @param path - API endpoint path
+     * @param params - URL query parameters
+     * @param body - Request body for POST requests
+     * @returns Promise resolving to response data
+     */
+    private makeRequest;
+    getTransactionByHash(hash: string): Promise<Transaction>;
+    getTransactionsByWalletBeforeTimestamp(wallet: string, filter: number, limit?: number, timestamp_lt?: string, last_hash?: string): Promise<ListTransactionResponse>;
+    getTransactionByWallet(wallet: string, page: number | undefined, limit: number | undefined, filter: number, sortBy?: string, sortOrder?: 'asc' | 'desc'): Promise<ListTransactionResponse>;
+    getWalletDetail(wallet: string): Promise<WalletDetail>;
 }
 
-declare class MmnClient {
-    private config;
-    private requestId;
-    constructor(config: MmnClientConfig);
-    private makeRequest;
-    /**
-     * Securely convert raw Ed25519 private key to PKCS#8 format
-     * @param raw - Raw 32-byte Ed25519 private key
-     * @returns PKCS#8 formatted private key in hex
-     * @throws Error if input validation fails
-     */
-    private rawEd25519ToPkcs8Hex;
-    /**
-     * Encode length in ASN.1 DER format
-     * ASN.1 length encoding rules:
-     * - Short form (0-127): single byte with the length value
-     * - Long form (128+): first byte is 0x80 + number of length bytes, followed by length bytes
-     * @param length - The length value to encode
-     * @returns ASN.1 DER encoded length bytes
-     */
-    private encodeLength;
-    /**
-     * Generate secure entropy using multiple sources for maximum compatibility
-     * @returns Array of 32 random bytes
-     */
-    private generateSecureEntropy;
-    /**
-     * Securely generate ephemeral key pair with proper entropy
-     * React Native compatible version with multiple fallbacks
-     * @returns Ephemeral key pair with private and public keys
-     * @throws Error if key generation fails
-     */
-    generateEphemeralKeyPair(): IEphemeralKeyPair;
-    getAddressFromUserId(userId: string): string;
-    /**
-     * Create and sign a transaction message
-     */
-    private createAndSignTx;
-    /**
-     * Securely sign a transaction with Ed25519
-     * @param tx - Transaction message to sign
-     * @param privateKeyHex - Private key in PKCS#8 hex format
-     * @returns Base58 encoded signature
-     * @throws Error if signing fails
-     */
-    private signTransaction;
-    /**
-     * Serialize transaction for signing
-     */
-    private serializeTransaction;
-    /**
-     * Add a signed transaction to the blockchain
-     */
-    private addTx;
-    /**
-     * Send a transaction (create, sign, and submit)
-     */
-    sendTransaction(params: SendTransactionRequest): Promise<AddTxResponse>;
-    sendTransactionByAddress(params: SendTransactionRequest): Promise<AddTxResponse>;
-    sendTransactionByPrivateKey(params: SendTransactionBase): Promise<AddTxResponse>;
-    /**
-     * Get current nonce for an account
-     */
-    getCurrentNonce(userId: string, tag?: 'latest' | 'pending'): Promise<GetCurrentNonceResponse>;
-    getAccountByUserId(userId: string): Promise<GetAccountByAddressResponse>;
-    scaleAmountToDecimals(originalAmount: string | number, decimals?: number): string;
-    validateAddress(addr: string): boolean;
-    validateAmount(balance: string, amount: string | number): boolean;
-}
+declare class MmnClient {
+    private config;
+    private requestId;
+    constructor(config: MmnClientConfig);
+    private makeRequest;
+    /**
+     * Securely convert raw Ed25519 private key to PKCS#8 format
+     * @param raw - Raw 32-byte Ed25519 private key
+     * @returns PKCS#8 formatted private key in hex
+     * @throws Error if input validation fails
+     */
+    private rawEd25519ToPkcs8Hex;
+    /**
+     * Encode length in ASN.1 DER format
+     * ASN.1 length encoding rules:
+     * - Short form (0-127): single byte with the length value
+     * - Long form (128+): first byte is 0x80 + number of length bytes, followed by length bytes
+     * @param length - The length value to encode
+     * @returns ASN.1 DER encoded length bytes
+     */
+    private encodeLength;
+    /**
+     * Generate secure entropy using multiple sources for maximum compatibility
+     * @returns Array of 32 random bytes
+     */
+    private generateSecureEntropy;
+    /**
+     * Securely generate ephemeral key pair with proper entropy
+     * React Native compatible version with multiple fallbacks
+     * @returns Ephemeral key pair with private and public keys
+     * @throws Error if key generation fails
+     */
+    generateEphemeralKeyPair(): IEphemeralKeyPair;
+    getAddressFromUserId(userId: string): string;
+    /**
+     * Create and sign a transaction message
+     */
+    private createAndSignTx;
+    /**
+     * Securely sign a transaction with Ed25519
+     * @param tx - Transaction message to sign
+     * @param privateKeyHex - Private key in PKCS#8 hex format
+     * @returns Base58 encoded signature
+     * @throws Error if signing fails
+     */
+    private signTransaction;
+    /**
+     * Serialize transaction for signing
+     */
+    private serializeTransaction;
+    /**
+     * Add a signed transaction to the blockchain
+     */
+    private addTx;
+    /**
+     * Send a transaction (create, sign, and submit)
+     */
+    sendTransaction(params: SendTransactionRequest): Promise<AddTxResponse>;
+    sendTransactionByAddress(params: SendTransactionRequest): Promise<AddTxResponse>;
+    sendTransactionByPrivateKey(params: SendTransactionBase): Promise<AddTxResponse>;
+    postDonationCampaignFeed(params: SendTransactionRequest): Promise<AddTxResponse>;
+    /**
+     * Get current nonce for an account
+     */
+    getCurrentNonce(userId: string, tag?: 'latest' | 'pending'): Promise<GetCurrentNonceResponse>;
+    getAccountByUserId(userId: string): Promise<GetAccountByAddressResponse>;
+    scaleAmountToDecimals(originalAmount: string | number, decimals?: number): string;
+    validateAddress(addr: string): boolean;
+    validateAmount(balance: string, amount: string | number): boolean;
+}
 declare function createMmnClient(config: MmnClientConfig): MmnClient;
 
-declare class ZkClient {
-    private endpoint;
-    private timeout;
-    private headers;
-    constructor(config: ZkClientConfig);
-    private makeRequest;
-    getZkProofs({ userId, ephemeralPublicKey, jwt, address, clientType, }: GetZkProofRequest): Promise<IZkProof>;
+declare class ZkClient {
+    private endpoint;
+    private timeout;
+    private headers;
+    constructor(config: ZkClientConfig);
+    private makeRequest;
+    getZkProofs({ userId, ephemeralPublicKey, jwt, address, clientType, }: GetZkProofRequest): Promise<IZkProof>;
 }
 
-export { AddTxResponse, ETransferType, EZkClientType, ExtraInfo, GetAccountByAddressResponse, GetCurrentNonceResponse, GetZkProofRequest, IEphemeralKeyPair, IZkProof, IndexerClient, IndexerClientConfig, JsonRpcError, JsonRpcRequest, JsonRpcResponse, ListTransactionResponse, Meta, MmnClient, MmnClientConfig, SendTransactionBase, SendTransactionRequest, SignedTx, Transaction, TransactionDetailResponse, TxMsg, WalletDetail, WalletDetailResponse, ZkClient, ZkClientConfig, createMmnClient };
+export { ETransferType, EZkClientType, IndexerClient, MmnClient, ZkClient, createMmnClient };
+export type { AddTxResponse, ExtraInfo, GetAccountByAddressResponse, GetCurrentNonceResponse, GetZkProofRequest, IEphemeralKeyPair, IZkProof, IndexerClientConfig, JsonRpcError, JsonRpcRequest, JsonRpcResponse, ListTransactionResponse, Meta, MmnClientConfig, SendTransactionBase, SendTransactionRequest, SignedTx, Transaction, TransactionDetailResponse, TxMsg, WalletDetail, WalletDetailResponse, ZkClientConfig };