mmn-client-js 1.0.9 → 1.0.11

package/dist/index.d.ts

@@ -0,0 +1,283 @@
+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 SendTransactionRequest {
+    sender: string;
+    recipient: string;
+    amount: string;
+    nonce: number;
+    timestamp?: number;
+    textData?: string;
+    extraInfo?: ExtraInfo;
+    publicKey: string;
+    privateKey: string;
+    zkProof: string;
+    zkPub: 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;
+}
+
+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 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>;
+    /**
+     * 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>;
+}
+
+export { ETransferType, EZkClientType, IndexerClient, MmnClient, ZkClient, createMmnClient };
+export type { AddTxResponse, ExtraInfo, GetAccountByAddressResponse, GetCurrentNonceResponse, GetZkProofRequest, IEphemeralKeyPair, IZkProof, IndexerClientConfig, JsonRpcError, JsonRpcRequest, JsonRpcResponse, ListTransactionResponse, Meta, MmnClientConfig, SendTransactionRequest, SignedTx, Transaction, TransactionDetailResponse, TxMsg, WalletDetail, WalletDetailResponse, ZkClientConfig };