mmn-client-js 1.0.10 → 1.0.12

package/README.md

@@ -105,7 +105,8 @@ const walletInfo = await indexerClient.getWalletDetail('wallet-address');
 // Create ZK client for proof generation
 const zkClient = new ZkClient({
   endpoint: 'https://zk.mmn.network',
-  chainId: 'mmn-mainnet',
+  timeout: 30000,
+  // chainId is not required for ZK client
 });
 
 // Generate ZK proof for authentication
@@ -178,6 +179,21 @@ const response = await client.sendTransaction({
 });
 ```
 
+**`sendTransactionByPrivateKey(params): Promise<AddTxResponse>`**
+Create, sign (using the provided private key) and submit a transaction without relying on a client-stored keypair.
+
+```typescript
+const response = await client.sendTransactionByPrivateKey({
+  sender: 'user123',
+  recipient: 'user456',
+  amount: '1000000000000000000',
+  nonce: 1,
+  textData: 'Optional message',
+  extraInfo: { type: 'transfer_token', UserSenderId: 'user123', ... },
+  privateKey: 'private-key-pkcs8-hex'
+});
+```
+
 **`getCurrentNonce(address: string, tag?: 'latest' | 'pending'): Promise<GetCurrentNonceResponse>`**
 Get current nonce for an account.
 

package/dist/index.d.ts

@@ -19,26 +19,23 @@ interface IEphemeralKeyPair {
     privateKey: string;
     publicKey: string;
 }
-interface IZkProof {
-    proof: string;
-    public_input: string;
-}
 declare enum ETransferType {
     GiveCoffee = "give_coffee",
     TransferToken = "transfer_token",
     UnlockItem = "unlock_item"
 }
 interface ExtraInfo {
-    type: ETransferType;
+    type: ETransferType | string;
     ItemId?: string;
     ItemType?: string;
     ClanId?: string;
     UserSenderId: string;
     UserSenderUsername: string;
-    UserReceiverId: string;
+    UserReceiverId?: string;
     ChannelId?: string;
     MessageRefId?: string;
     ExtraAttribute?: string;
+    [x: string]: string;
 }
 interface TxMsg {
     type: number;
@@ -166,6 +163,21 @@ interface ZkClientConfig {
     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;
@@ -246,12 +258,16 @@ declare class MmnClient {
      * Send a transaction (create, sign, and submit)
      */
     sendTransaction(params: SendTransactionRequest): Promise<AddTxResponse>;
+    sendTransactionByAddress(params: SendTransactionRequest): Promise<AddTxResponse>;
+    sendTransactionByPrivateKey(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;
 
@@ -261,13 +277,8 @@ declare class ZkClient {
     private headers;
     constructor(config: ZkClientConfig);
     private makeRequest;
-    getZkProofs({ userId, ephemeralPublicKey, jwt, address, }: {
-        userId: string;
-        ephemeralPublicKey: string;
-        jwt: string;
-        address: string;
-    }): Promise<IZkProof>;
+    getZkProofs({ userId, ephemeralPublicKey, jwt, address, clientType, }: GetZkProofRequest): Promise<IZkProof>;
 }
 
-export { ETransferType, IndexerClient, MmnClient, ZkClient, createMmnClient };
-export type { AddTxResponse, ExtraInfo, GetAccountByAddressResponse, GetCurrentNonceResponse, IEphemeralKeyPair, IZkProof, IndexerClientConfig, JsonRpcError, JsonRpcRequest, JsonRpcResponse, ListTransactionResponse, Meta, MmnClientConfig, SendTransactionRequest, SignedTx, Transaction, TransactionDetailResponse, TxMsg, WalletDetail, WalletDetailResponse, ZkClientConfig };
+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 };

package/dist/index.esm.js

@@ -7678,7 +7678,7 @@ const PRNG_CONSTANTS = {
 };
 const TX_TYPE = {
     TRANSFER: 0,
-    FAUCET: 1,
+    PRIVATE_KEY: 1,
 };
 const DECIMALS = 6;
 class MmnClient {
@@ -7928,12 +7928,19 @@ class MmnClient {
      * Create and sign a transaction message
      */
     createAndSignTx(params) {
-        const fromAddress = this.getAddressFromUserId(params.sender);
-        const toAddress = this.getAddressFromUserId(params.recipient);
+        if (!this.validateAddress(params.sender)) {
+            throw new Error('Invalid sender address');
+        }
+        if (!this.validateAddress(params.recipient)) {
+            throw new Error('Invalid recipient address');
+        }
+        if (params.sender === params.recipient) {
+            throw new Error('Sender and recipient addresses cannot be the same');
+        }
         const txMsg = {
             type: params.type,
-            sender: fromAddress,
-            recipient: toAddress,
+            sender: params.sender,
+            recipient: params.recipient,
             amount: params.amount,
             timestamp: params.timestamp || Date.now(),
             text_data: params.textData || '',
@@ -7990,7 +7997,7 @@ class MmnClient {
             seed.fill(0);
             keyPair.secretKey.fill(0);
             // Return signature based on transaction type
-            if (tx.type === TX_TYPE.FAUCET) {
+            if (tx.type === TX_TYPE.PRIVATE_KEY) {
                 return bs58.encode(BufferCompat.from(signature));
             }
             // For regular transactions, wrap signature with public key
@@ -8021,9 +8028,27 @@ class MmnClient {
      * Send a transaction (create, sign, and submit)
      */
     async sendTransaction(params) {
+        const fromAddress = this.getAddressFromUserId(params.sender);
+        const toAddress = this.getAddressFromUserId(params.recipient);
         const signedTx = this.createAndSignTx({
             ...params,
             type: TX_TYPE.TRANSFER,
+            sender: fromAddress,
+            recipient: toAddress,
+        });
+        return this.addTx(signedTx);
+    }
+    async sendTransactionByAddress(params) {
+        const signedTx = this.createAndSignTx({
+            ...params,
+            type: TX_TYPE.TRANSFER,
+        });
+        return this.addTx(signedTx);
+    }
+    async sendTransactionByPrivateKey(params) {
+        const signedTx = this.createAndSignTx({
+            ...params,
+            type: TX_TYPE.PRIVATE_KEY,
         });
         return this.addTx(signedTx);
     }
@@ -8047,6 +8072,19 @@ class MmnClient {
         }
         return scaledAmount.toString();
     }
+    validateAddress(addr) {
+        const decoded = bs58.decode(addr);
+        if (!decoded ||
+            decoded.length !== CRYPTO_CONSTANTS.ED25519_PUBLIC_KEY_LENGTH) {
+            return false;
+        }
+        return true;
+    }
+    validateAmount(balance, amount) {
+        const bigBalance = BigInt(balance);
+        const bigAmount = BigInt(typeof amount === 'number' ? this.scaleAmountToDecimals(amount) : amount);
+        return bigAmount <= bigBalance;
+    }
 }
 function createMmnClient(config) {
     return new MmnClient(config);
@@ -8059,6 +8097,11 @@ var ETransferType;
     ETransferType["TransferToken"] = "transfer_token";
     ETransferType["UnlockItem"] = "unlock_item";
 })(ETransferType || (ETransferType = {}));
+var EZkClientType;
+(function (EZkClientType) {
+    EZkClientType["MEZON"] = "mezon";
+    EZkClientType["OAUTH"] = "oauth";
+})(EZkClientType || (EZkClientType = {}));
 
 class ZkClient {
     constructor(config) {
@@ -8114,17 +8157,18 @@ class ZkClient {
             throw new Error('Request failed');
         }
     }
-    async getZkProofs({ userId, ephemeralPublicKey, jwt, address, }) {
+    async getZkProofs({ userId, ephemeralPublicKey, jwt, address, clientType = EZkClientType.MEZON, }) {
         const path = `prove`;
         const res = await this.makeRequest('POST', path, undefined, {
             user_id: userId,
             ephemeral_pk: ephemeralPublicKey,
             jwt,
             address,
+            client_type: clientType,
         });
         return res.data;
     }
 }
 
-export { ETransferType, IndexerClient, MmnClient, ZkClient, createMmnClient };
+export { ETransferType, EZkClientType, IndexerClient, MmnClient, ZkClient, createMmnClient };
 //# sourceMappingURL=index.esm.js.map