@1money/protocol-ts-sdk 1.1.2 → 2.0.0

package/lib/signing/builders/tokenBurnAndBridge.d.ts

@@ -0,0 +1,3 @@
+import type { TokenBurnAndBridgePayload } from '../../api/tokens/types';
+export type TokenBurnAndBridgeUnsigned = Omit<TokenBurnAndBridgePayload, 'signature'>;
+export declare function prepareTokenBurnAndBridgeTx(unsigned: TokenBurnAndBridgeUnsigned): import("../core").PreparedTx<TokenBurnAndBridgeUnsigned, TokenBurnAndBridgePayload>;

package/lib/signing/builders/tokenClawback.d.ts

@@ -0,0 +1,3 @@
+import type { TokenClawbackPayload } from '../../api/tokens/types';
+export type TokenClawbackUnsigned = Omit<TokenClawbackPayload, 'signature'>;
+export declare function prepareTokenClawbackTx(unsigned: TokenClawbackUnsigned): import("../core").PreparedTx<TokenClawbackUnsigned, TokenClawbackPayload>;

package/lib/signing/builders/tokenIssue.d.ts

@@ -0,0 +1,3 @@
+import type { TokenIssuePayload } from '../../api/tokens/types';
+export type TokenIssueUnsigned = Omit<TokenIssuePayload, 'signature'>;
+export declare function prepareTokenIssueTx(unsigned: TokenIssueUnsigned): import("../core").PreparedTx<TokenIssueUnsigned, TokenIssuePayload>;

package/lib/signing/builders/tokenManageList.d.ts

@@ -0,0 +1,3 @@
+import type { TokenManageListPayload } from '../../api/tokens/types';
+export type TokenManageListUnsigned = Omit<TokenManageListPayload, 'signature'>;
+export declare function prepareTokenManageListTx(unsigned: TokenManageListUnsigned): import("../core").PreparedTx<TokenManageListUnsigned, TokenManageListPayload>;

package/lib/signing/builders/tokenMetadata.d.ts

@@ -0,0 +1,3 @@
+import type { TokenMetadataPayload } from '../../api/tokens/types';
+export type TokenMetadataUnsigned = Omit<TokenMetadataPayload, 'signature'>;
+export declare function prepareTokenMetadataTx(unsigned: TokenMetadataUnsigned): import("../core").PreparedTx<TokenMetadataUnsigned, TokenMetadataPayload>;

package/lib/signing/builders/tokenMint.d.ts

@@ -0,0 +1,3 @@
+import type { TokenMintPayload } from '../../api/tokens/types';
+export type TokenMintUnsigned = Omit<TokenMintPayload, 'signature'>;
+export declare function prepareTokenMintTx(unsigned: TokenMintUnsigned): import("../core").PreparedTx<TokenMintUnsigned, TokenMintPayload>;

package/lib/signing/builders/tokenPause.d.ts

@@ -0,0 +1,3 @@
+import type { TokenPausePayload } from '../../api/tokens/types';
+export type TokenPauseUnsigned = Omit<TokenPausePayload, 'signature'>;
+export declare function prepareTokenPauseTx(unsigned: TokenPauseUnsigned): import("../core").PreparedTx<TokenPauseUnsigned, TokenPausePayload>;

package/lib/signing/builders/validate.d.ts

@@ -0,0 +1,18 @@
+export declare function assertPositiveInteger(name: string, value: number): void;
+export declare function assertNonNegativeInteger(name: string, value: number): void;
+export declare function assertUintString(name: string, value: string): void;
+export declare function assertOptionalUintString(name: string, value: string | undefined): void;
+export declare function assertAddress(name: string, value: string): void;
+export declare function validateChainAndNonce(unsigned: {
+    chain_id: number;
+    nonce: number;
+}): void;
+export declare function validateRecipientValueToken(unsigned: {
+    recipient: string;
+    value: string;
+    token: string;
+}): void;
+export declare function validateValueToken(unsigned: {
+    value: string;
+    token: string;
+}): void;

package/lib/signing/core.d.ts

@@ -0,0 +1,27 @@
+import type { Signature, ZeroXString } from '../utils/index.js';
+export interface SignerAdapter {
+    signDigest: (digest: ZeroXString) => Promise<Signature>;
+}
+export interface SignedTx<TUnsigned, TRequest> {
+    kind: string;
+    unsigned: TUnsigned;
+    signatureHash: ZeroXString;
+    txHash: ZeroXString;
+    signature: Signature;
+    toRequest: () => TRequest;
+}
+export interface PreparedTx<TUnsigned, TRequest> {
+    kind: string;
+    unsigned: TUnsigned;
+    rlpBytes: Uint8Array;
+    signatureHash: ZeroXString;
+    attachSignature: (signature: Signature) => SignedTx<TUnsigned, TRequest>;
+    sign: (signer: SignerAdapter) => Promise<SignedTx<TUnsigned, TRequest>>;
+}
+export declare function calcSignedTxHash(payloadRlpBytes: Uint8Array, signature: Signature): ZeroXString;
+export declare function createPreparedTx<TUnsigned, TRequest>(params: {
+    kind: string;
+    unsigned: TUnsigned;
+    rlpBytes: Uint8Array;
+    toRequest: (unsigned: TUnsigned, signature: Signature) => TRequest;
+}): PreparedTx<TUnsigned, TRequest>;

package/lib/signing/index.d.ts

@@ -0,0 +1,18 @@
+import { preparePaymentTx, prepareTokenAuthorityTx, prepareTokenBridgeAndMintTx, prepareTokenBurnAndBridgeTx, prepareTokenBurnTx, prepareTokenClawbackTx, prepareTokenIssueTx, prepareTokenManageListTx, prepareTokenMetadataTx, prepareTokenMintTx, prepareTokenPauseTx } from './builders';
+export * from './builders';
+export * from './core';
+export * from './signer';
+export declare const TransactionBuilder: {
+    payment: typeof preparePaymentTx;
+    tokenManageList: typeof prepareTokenManageListTx;
+    tokenBurn: typeof prepareTokenBurnTx;
+    tokenAuthority: typeof prepareTokenAuthorityTx;
+    tokenIssue: typeof prepareTokenIssueTx;
+    tokenMint: typeof prepareTokenMintTx;
+    tokenPause: typeof prepareTokenPauseTx;
+    tokenMetadata: typeof prepareTokenMetadataTx;
+    tokenBridgeAndMint: typeof prepareTokenBridgeAndMintTx;
+    tokenBurnAndBridge: typeof prepareTokenBurnAndBridgeTx;
+    tokenClawback: typeof prepareTokenClawbackTx;
+};
+export default TransactionBuilder;

package/lib/signing/signer.d.ts

@@ -0,0 +1,3 @@
+import type { ZeroXString } from '../utils/index.js';
+import type { SignerAdapter } from './core';
+export declare function createPrivateKeySigner(privateKey: ZeroXString): SignerAdapter;

package/lib/utils/encode.d.ts

@@ -0,0 +1,11 @@
+import type { PlpPayload, ZeroXString } from './interface';
+export declare const rlpValue: {
+    address: (v: ZeroXString) => PlpPayload;
+    hex: (v: ZeroXString) => PlpPayload;
+    string: (v: string) => PlpPayload;
+    uint: (v: bigint | number | string) => PlpPayload;
+    bool: (v: boolean) => PlpPayload;
+    bytes: (v: Uint8Array) => PlpPayload;
+    list: (v: PlpPayload[]) => PlpPayload;
+};
+export declare function encodeRlpPayload(payload: PlpPayload): Uint8Array<ArrayBufferLike>;

package/lib/utils/index.d.ts

@@ -1,6 +1,7 @@
 export * from './address';
+export * from './encode';
 export * from './safePromise';
-export * from './typeof';
 export * from './sign';
 export * from './txHash';
+export * from './typeof';
 export type * from './interface';

package/lib/utils/index.js

@@ -25,6 +25,81 @@ function deriveTokenAddress(walletAddress, mintAddress) {
     var hashBytes = viem.hexToBytes(hashHex);
     var addressBytes = hashBytes.slice(12);
     return viem.bytesToHex(addressBytes);
+}var ADDRESS_HEX_RE = /^0x[0-9a-fA-F]{40}$/;
+var BYTES_HEX_RE = /^0x([0-9a-fA-F]{2})*$/;
+function innerEncodeRlpPayload(value) {
+    if (value === null || value === undefined) {
+        return new Uint8Array([]);
+    }
+    switch (value.kind) {
+        case 'string':
+            return new TextEncoder().encode(value.value);
+        case 'uint': {
+            if (typeof value.value === 'string' &&
+                !/^\d+$/.test(value.value)) {
+                throw new Error("[1Money SDK]: Invalid uint string: ".concat(value.value));
+            }
+            var n = typeof value.value === 'bigint'
+                ? value.value
+                : BigInt(value.value);
+            return n === BigInt(0)
+                ? new Uint8Array([])
+                : viem.hexToBytes(viem.numberToHex(n));
+        }
+        case 'bool':
+            return value.value
+                ? Uint8Array.from([1])
+                : new Uint8Array([]);
+        case 'bytes':
+            return value.value;
+        case 'list':
+            return value.value.map(function (v) { return innerEncodeRlpPayload(v); });
+        case 'address':
+        case 'hex':
+            if (!BYTES_HEX_RE.test(value.value)) {
+                throw new Error("[1Money SDK]: Invalid hex value: ".concat(value.value));
+            }
+            if (value.kind === 'address' &&
+                !ADDRESS_HEX_RE.test(value.value)) {
+                throw new Error("[1Money SDK]: Invalid address value: ".concat(value.value));
+            }
+            return value.value === '0x'
+                ? new Uint8Array([])
+                : viem.hexToBytes(value.value);
+    }
+}
+var rlpValue = {
+    address: function (v) { return ({
+        kind: 'address',
+        value: v
+    }); },
+    hex: function (v) { return ({
+        kind: 'hex',
+        value: v
+    }); },
+    string: function (v) { return ({
+        kind: 'string',
+        value: v
+    }); },
+    uint: function (v) { return ({
+        kind: 'uint',
+        value: v
+    }); },
+    bool: function (v) { return ({
+        kind: 'bool',
+        value: v
+    }); },
+    bytes: function (v) { return ({
+        kind: 'bytes',
+        value: v
+    }); },
+    list: function (v) { return ({
+        kind: 'list',
+        value: v
+    }); }
+};
+function encodeRlpPayload(payload) {
+    return rlp.encode(innerEncodeRlpPayload(payload));
 }/******************************************************************************
 Copyright (c) Microsoft Corporation.
 
@@ -132,11 +207,6 @@ function safePromiseLine(arr) {
             }
         });
     });
-}function _typeof(ele) {
-    if (typeof ele !== 'object')
-        return (typeof ele).toLowerCase();
-    var typeStr = Object.prototype.toString.call(ele);
-    return typeStr.slice(8, typeStr.length - 1).toLowerCase();
 }/*! noble-secp256k1 - MIT License (c) 2019 Paul Miller (paulmillr.com) */
 /**
  * 4KB JS implementation of secp256k1 ECDSA / Schnorr signatures & ECDH.
@@ -792,8 +862,15 @@ const wNAF = (n) => {
         }
     }
     return { p, f }; // return both real and fake points for JIT
-};/**
+};function _typeof(ele) {
+    if (typeof ele !== 'object')
+        return (typeof ele).toLowerCase();
+    var typeStr = Object.prototype.toString.call(ele);
+    return typeStr.slice(8, typeStr.length - 1).toLowerCase();
+}/**
  * RLP encode a payload into a digest
+ * @deprecated Prefer the TransactionBuilder flow in `src/signing`
+ * (`prepare*Tx` + `.sign(...)`) to build and sign transactions.
  * @param payload Payload to encode
  * @returns RLP encoded payload
  */
@@ -801,9 +878,9 @@ function encodePayload(payload) {
     if (_typeof(payload) === 'array') {
         var formatted = payload.map(function (v) {
             if (_typeof(v) === 'string') {
-                if (/^0x[0-9a-fA-F]+$/.test(v)) {
+                if (/^0x([0-9a-fA-F]{2})*$/.test(v)) {
                     // hex-encoded data → raw bytes
-                    return viem.hexToBytes(v);
+                    return v === '0x' ? new Uint8Array([]) : viem.hexToBytes(v);
                 }
                 else if (/^\d+$/.test(v)) {
                     // number-like string → hex → bytes
@@ -835,6 +912,9 @@ function encodePayload(payload) {
 }
 /**
  * Sign a message using the provided private key
+ * @deprecated Prefer the TransactionBuilder flow in `src/signing`
+ * (`prepare*Tx` + `.sign(createPrivateKeySigner(privateKey))`)
+ * for transaction signing.
  * @param payload Payload to sign
  * @param privateKey Private key to sign with
  * @returns Signature object with r, s, v components
@@ -905,7 +985,7 @@ function toHex(value) {
         }
     }
     catch (e) {
-        console.error('[1Money toHex]: ', e);
+        console.error('[1Money SDK]: toHex error:', e);
         return '0x';
     }
 }function encodeRlpListHeader(length) {
@@ -943,4 +1023,4 @@ function calcTxHash(payload, signature) {
     encoded.set(pEncode, header.length);
     encoded.set(vrsBytes, header.length + pEncode.length);
     return viem.keccak256(encoded);
-}exports._typeof=_typeof;exports.calcTxHash=calcTxHash;exports.deriveTokenAddress=deriveTokenAddress;exports.encodePayload=encodePayload;exports.safePromiseAll=safePromiseAll;exports.safePromiseLine=safePromiseLine;exports.signMessage=signMessage;exports.toHex=toHex;
+}exports._typeof=_typeof;exports.calcTxHash=calcTxHash;exports.deriveTokenAddress=deriveTokenAddress;exports.encodePayload=encodePayload;exports.encodeRlpPayload=encodeRlpPayload;exports.rlpValue=rlpValue;exports.safePromiseAll=safePromiseAll;exports.safePromiseLine=safePromiseLine;exports.signMessage=signMessage;exports.toHex=toHex;

package/lib/utils/interface.d.ts

@@ -4,4 +4,31 @@ export interface Signature {
     s: ZeroXString;
     v: number | boolean;
 }
+/**
+ * @deprecated Legacy payload shape used by deprecated `encodePayload`
+ * and `signMessage`. Prefer `PlpPayload`/`encodeRlpPayload` and
+ * TransactionBuilder in `src/signing`.
+ */
 export type Payload = boolean | string | number | bigint | Uint8Array | Array<Payload> | null | undefined;
+export type PlpPayload = {
+    kind: 'address';
+    value: ZeroXString;
+} | {
+    kind: 'hex';
+    value: ZeroXString;
+} | {
+    kind: 'string';
+    value: string;
+} | {
+    kind: 'uint';
+    value: bigint | number | string;
+} | {
+    kind: 'bool';
+    value: boolean;
+} | {
+    kind: 'bytes';
+    value: Uint8Array;
+} | {
+    kind: 'list';
+    value: PlpPayload[];
+} | null | undefined;

package/lib/utils/sign.d.ts

@@ -1,12 +1,17 @@
-import type { ZeroXString, Signature, Payload } from './interface';
+import type { Payload, Signature, ZeroXString } from './interface';
 /**
  * RLP encode a payload into a digest
+ * @deprecated Prefer the TransactionBuilder flow in `src/signing`
+ * (`prepare*Tx` + `.sign(...)`) to build and sign transactions.
  * @param payload Payload to encode
  * @returns RLP encoded payload
  */
 export declare function encodePayload(payload: Payload): Uint8Array<ArrayBufferLike>;
 /**
  * Sign a message using the provided private key
+ * @deprecated Prefer the TransactionBuilder flow in `src/signing`
+ * (`prepare*Tx` + `.sign(createPrivateKeySigner(privateKey))`)
+ * for transaction signing.
  * @param payload Payload to sign
  * @param privateKey Private key to sign with
  * @returns Signature object with r, s, v components

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@1money/protocol-ts-sdk",
-  "version": "1.1.2",
+  "version": "2.0.0",
   "description": "ts sdk for 1Money protocol network",
   "main": "lib/index.js",
   "module": "es/index.js",
@@ -75,7 +75,7 @@
     "@commitlint/cli": "8.3.5",
     "@ethereumjs/rlp": "^10.0.0",
     "@noble/secp256k1": "2.3.0",
-    "@omni-door/cli": "~3.1.1",
+    "@omni-door/cli": "~3.2.2",
     "@rollup/plugin-alias": "~5.1.1",
     "@rollup/plugin-babel": "~6.0.4",
     "@rollup/plugin-commonjs": "~28.0.3",