@orbinum/sdk 0.7.1 → 0.7.3

package/dist/index.d.mts

@@ -182,11 +182,11 @@ declare class SubstrateClient {
      */
     submitAndWatch(signedHex: string): ReturnType<PolkadotClient['submitAndWatch']>;
     /**
-     * Submits a bare (unsigned) extrinsic hex and waits for finalization.
+     * Submits a bare (unsigned) extrinsic and waits for finalization.
      * Used for gasless private_transfer and unshield transactions.
-     * The bare tx hex is produced by `tx.getBareTx()` from polkadot-api.
+     * The bare tx bytes are produced by `tx.getBareTx()` from polkadot-api.
      */
-    submitUnsignedAndWatch(bareTxHex: string): Promise<TxFinalizedPayload>;
+    submitUnsignedAndWatch(bareTx: Uint8Array): Promise<TxFinalizedPayload>;
     /**
      * Convenience: wrap raw call bytes and sign+submit in one step.
      */
@@ -432,7 +432,7 @@ declare class EvmExplorer {
     getTransactionsByAddress(address: string, maxBlocks?: number): Promise<EvmTxSummary[]>;
     /**
      * Returns aggregated on-chain data for an EVM address: balance, nonce,
-     * bytecode (truncated), and up to 50 recent logs from the last 5 000 blocks.
+     * bytecode (truncated), and up to 50 recent logs from the last 1 000 blocks.
      */
     getAddressInfo(address: string): Promise<EvmAddressInfo>;
     /** Returns the native token balance of `address`, formatted as a decimal string (no symbol). */
@@ -447,7 +447,7 @@ declare class EvmExplorer {
      */
     getTokenInfo(address: string): Promise<TokenInfo | null>;
     /**
-     * Returns ERC-20 `Transfer` events for `address` from the last 5 000 blocks.
+     * Returns ERC-20 `Transfer` events for `address` from the last 1 000 blocks.
      * When `holderAddress` is provided, restricts results to transfers sent or received by that address.
      */
     getTokenTransfers(address: string, holderAddress?: string): Promise<TokenTransfer[]>;
@@ -494,7 +494,13 @@ interface ShieldedCommitment {
     blockNumber: number;
     extrinsicIndex: number | null;
     leafIndex: number;
-    /** Asset ID as decimal string (e.g. "0"). */
+    /**
+     * Asset ID as decimal string.
+     * For `source: 'shield'` and `source: 'unshield'` this reflects the real asset.
+     * For `source: 'transfer'` it is always `"0"` — the chain intentionally omits the asset ID
+     * from `CommitmentsInserted` events to prevent graph correlation across assets.
+     * The true asset is recoverable only by decrypting `encryptedMemo`.
+     */
     assetId: string;
     /** Origin of the commitment: direct shield, output of private transfer, or change from unshield. */
     source: 'shield' | 'transfer' | 'unshield';
@@ -519,6 +525,18 @@ interface PrivateTransferTimestamp {
     /** Blake2-256 hash of the raw extrinsic, 0x-prefixed. Null if the extrinsic was not decoded. */
     hash: string | null;
     timestampMs: number | null;
+    /**
+     * Subset of the queried nullifiers that were spent in this specific extrinsic.
+     * Returned by `getTransfersByNullifiers`. Use to identify which input vault notes
+     * belong to this transfer for local reconstruction.
+     */
+    matchedNullifiers?: string[];
+    /**
+     * Subset of the queried commitments that were inserted in this specific extrinsic.
+     * Returned by `getTransfersByCommitments`. Use to identify which output vault notes
+     * (change notes or received notes) belong to this transfer.
+     */
+    matchedCommitments?: string[];
 }
 /** An unshield event stored by the indexer. */
 interface Unshield {
@@ -691,7 +709,13 @@ type ShieldedAddressEvent = ({
 interface StealthScanHint {
     leafIndex: number;
     commitmentHex: string;
-    /** Asset ID as decimal string (e.g. "0"). */
+    /**
+     * Asset ID as decimal string.
+     * For shield-origin commitments this is the real asset ID.
+     * For transfer-origin commitments this is always `"0"` — the chain does not emit the asset ID
+     * in `CommitmentsInserted` events by design (privacy: prevents cross-asset graph correlation).
+     * Recover the true asset by decrypting `encryptedMemo`.
+     */
     assetId: string;
     /** Ephemeral public key (last 32 bytes of encrypted_memo), 0x-prefixed. null if memo absent. */
     ephPkHex: string | null;

package/dist/index.d.ts

@@ -182,11 +182,11 @@ declare class SubstrateClient {
      */
     submitAndWatch(signedHex: string): ReturnType<PolkadotClient['submitAndWatch']>;
     /**
-     * Submits a bare (unsigned) extrinsic hex and waits for finalization.
+     * Submits a bare (unsigned) extrinsic and waits for finalization.
      * Used for gasless private_transfer and unshield transactions.
-     * The bare tx hex is produced by `tx.getBareTx()` from polkadot-api.
+     * The bare tx bytes are produced by `tx.getBareTx()` from polkadot-api.
      */
-    submitUnsignedAndWatch(bareTxHex: string): Promise<TxFinalizedPayload>;
+    submitUnsignedAndWatch(bareTx: Uint8Array): Promise<TxFinalizedPayload>;
     /**
      * Convenience: wrap raw call bytes and sign+submit in one step.
      */
@@ -432,7 +432,7 @@ declare class EvmExplorer {
     getTransactionsByAddress(address: string, maxBlocks?: number): Promise<EvmTxSummary[]>;
     /**
      * Returns aggregated on-chain data for an EVM address: balance, nonce,
-     * bytecode (truncated), and up to 50 recent logs from the last 5 000 blocks.
+     * bytecode (truncated), and up to 50 recent logs from the last 1 000 blocks.
      */
     getAddressInfo(address: string): Promise<EvmAddressInfo>;
     /** Returns the native token balance of `address`, formatted as a decimal string (no symbol). */
@@ -447,7 +447,7 @@ declare class EvmExplorer {
      */
     getTokenInfo(address: string): Promise<TokenInfo | null>;
     /**
-     * Returns ERC-20 `Transfer` events for `address` from the last 5 000 blocks.
+     * Returns ERC-20 `Transfer` events for `address` from the last 1 000 blocks.
      * When `holderAddress` is provided, restricts results to transfers sent or received by that address.
      */
     getTokenTransfers(address: string, holderAddress?: string): Promise<TokenTransfer[]>;
@@ -494,7 +494,13 @@ interface ShieldedCommitment {
     blockNumber: number;
     extrinsicIndex: number | null;
     leafIndex: number;
-    /** Asset ID as decimal string (e.g. "0"). */
+    /**
+     * Asset ID as decimal string.
+     * For `source: 'shield'` and `source: 'unshield'` this reflects the real asset.
+     * For `source: 'transfer'` it is always `"0"` — the chain intentionally omits the asset ID
+     * from `CommitmentsInserted` events to prevent graph correlation across assets.
+     * The true asset is recoverable only by decrypting `encryptedMemo`.
+     */
     assetId: string;
     /** Origin of the commitment: direct shield, output of private transfer, or change from unshield. */
     source: 'shield' | 'transfer' | 'unshield';
@@ -519,6 +525,18 @@ interface PrivateTransferTimestamp {
     /** Blake2-256 hash of the raw extrinsic, 0x-prefixed. Null if the extrinsic was not decoded. */
     hash: string | null;
     timestampMs: number | null;
+    /**
+     * Subset of the queried nullifiers that were spent in this specific extrinsic.
+     * Returned by `getTransfersByNullifiers`. Use to identify which input vault notes
+     * belong to this transfer for local reconstruction.
+     */
+    matchedNullifiers?: string[];
+    /**
+     * Subset of the queried commitments that were inserted in this specific extrinsic.
+     * Returned by `getTransfersByCommitments`. Use to identify which output vault notes
+     * (change notes or received notes) belong to this transfer.
+     */
+    matchedCommitments?: string[];
 }
 /** An unshield event stored by the indexer. */
 interface Unshield {
@@ -691,7 +709,13 @@ type ShieldedAddressEvent = ({
 interface StealthScanHint {
     leafIndex: number;
     commitmentHex: string;
-    /** Asset ID as decimal string (e.g. "0"). */
+    /**
+     * Asset ID as decimal string.
+     * For shield-origin commitments this is the real asset ID.
+     * For transfer-origin commitments this is always `"0"` — the chain does not emit the asset ID
+     * in `CommitmentsInserted` events by design (privacy: prevents cross-asset graph correlation).
+     * Recover the true asset by decrypting `encryptedMemo`.
+     */
     assetId: string;
     /** Ephemeral public key (last 32 bytes of encrypted_memo), 0x-prefixed. null if memo absent. */
     ephPkHex: string | null;

package/dist/index.js

@@ -369,12 +369,12 @@ var SubstrateClient = class _SubstrateClient {
     return this._papi.submitAndWatch(import_polkadot_api.Binary.fromHex(signedHex));
   }
   /**
-   * Submits a bare (unsigned) extrinsic hex and waits for finalization.
+   * Submits a bare (unsigned) extrinsic and waits for finalization.
    * Used for gasless private_transfer and unshield transactions.
-   * The bare tx hex is produced by `tx.getBareTx()` from polkadot-api.
+   * The bare tx bytes are produced by `tx.getBareTx()` from polkadot-api.
    */
-  async submitUnsignedAndWatch(bareTxHex) {
-    return this._papi.submit(import_polkadot_api.Binary.fromHex(bareTxHex));
+  async submitUnsignedAndWatch(bareTx) {
+    return this._papi.submit(bareTx);
   }
   /**
    * Convenience: wrap raw call bytes and sign+submit in one step.
@@ -765,6 +765,7 @@ function formatORB(raw, precision = 6) {
 }
 
 // src/evm-explorer/EvmExplorer.ts
+var MAX_LOG_BLOCK_RANGE = 1e3;
 var EvmExplorer = class _EvmExplorer {
   /** @param evm - Underlying `EvmClient` used for all RPC calls. */
   constructor(evm) {
@@ -874,11 +875,11 @@ var EvmExplorer = class _EvmExplorer {
   // --- Address ---
   /**
    * Returns aggregated on-chain data for an EVM address: balance, nonce,
-   * bytecode (truncated), and up to 50 recent logs from the last 5 000 blocks.
+   * bytecode (truncated), and up to 50 recent logs from the last 1 000 blocks.
    */
   async getAddressInfo(address) {
     const latest = await this.evm.getBlockNumber().catch(() => 0);
-    const fromBlock = `0x${Math.max(0, latest - 5e3).toString(16)}`;
+    const fromBlock = `0x${Math.max(0, latest - MAX_LOG_BLOCK_RANGE).toString(16)}`;
     const [balance, nonce, code, logs] = await Promise.all([
       this.evm.request("eth_getBalance", [address, "latest"]).catch(() => null),
       this.evm.getTransactionCount(address).catch(() => 0),
@@ -957,13 +958,13 @@ var EvmExplorer = class _EvmExplorer {
     };
   }
   /**
-   * Returns ERC-20 `Transfer` events for `address` from the last 5 000 blocks.
+   * Returns ERC-20 `Transfer` events for `address` from the last 1 000 blocks.
    * When `holderAddress` is provided, restricts results to transfers sent or received by that address.
    */
   async getTokenTransfers(address, holderAddress) {
     const TRANSFER = "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef";
     const latest = await this.evm.getBlockNumber().catch(() => 0);
-    const fromBlock = `0x${Math.max(0, latest - 5e3).toString(16)}`;
+    const fromBlock = `0x${Math.max(0, latest - MAX_LOG_BLOCK_RANGE).toString(16)}`;
     let logs;
     if (holderAddress) {
       const padded = `0x${holderAddress.replace(/^0x/, "").toLowerCase().padStart(64, "0")}`;
@@ -1398,8 +1399,8 @@ function callUnsafeTx(txEntry, ...args) {
   return txEntry(...args);
 }
 async function submitBareTx(tx, client) {
-  const bareTxHex = await tx.getBareTx();
-  const payload = await client.submitUnsignedAndWatch(bareTxHex);
+  const bareTx = await tx.getBareTx();
+  const payload = await client.submitUnsignedAndWatch(bareTx);
   return toTxResult(payload);
 }
 function resolveTx(unsafe, pallet, call) {
@@ -1821,7 +1822,7 @@ var ShieldedPoolModule = class {
     const tx = callUnsafeTx(entry, {
       asset_id: params.assetId,
       amount: params.amount,
-      commitment: import_polkadot_api2.Binary.fromHex(params.commitment),
+      commitment: params.commitment,
       encrypted_memo: params.encryptedMemo
     });
     return toTxResult(
@@ -1848,13 +1849,13 @@ var ShieldedPoolModule = class {
     }
     const tx = callUnsafeTx(entry, {
       proof: params.proof,
-      merkle_root: import_polkadot_api2.Binary.fromHex(params.merkleRoot),
-      nullifier: import_polkadot_api2.Binary.fromHex(params.nullifier),
+      merkle_root: params.merkleRoot,
+      nullifier: params.nullifier,
       asset_id: params.assetId,
       amount: params.amount,
       recipient: recipientSs58,
       fee: params.fee ?? 0n,
-      change_commitment: import_polkadot_api2.Binary.fromHex(changeCommitment),
+      change_commitment: changeCommitment,
       change_encrypted_memo: changeEncryptedMemo,
       relayer: void 0
       // Option<H160> — None for direct Substrate submissions
@@ -1873,8 +1874,8 @@ var ShieldedPoolModule = class {
    * Extrinsic: shieldedPool.privateTransfer(proof, merkleRoot, nullifiers, commitments, memos, assetId, fee)
    */
   async privateTransfer(params, signer, txOptions) {
-    const nullifiers = params.inputs.map((inp) => import_polkadot_api2.Binary.fromHex(inp.nullifier));
-    const commitments = params.outputs.map((out) => import_polkadot_api2.Binary.fromHex(out.commitment));
+    const nullifiers = params.inputs.map((inp) => inp.nullifier);
+    const commitments = params.outputs.map((out) => out.commitment);
     const memos = params.outputs.map((out, i) => {
       EncryptedMemo.validate(
         out.encryptedMemo,
@@ -1885,7 +1886,7 @@ var ShieldedPoolModule = class {
     const entry = resolveTx(this.substrate.unsafe, "ShieldedPool", "private_transfer");
     const tx = callUnsafeTx(entry, {
       proof: params.proof,
-      merkle_root: import_polkadot_api2.Binary.fromHex(params.merkleRoot),
+      merkle_root: params.merkleRoot,
       nullifiers,
       commitments,
       encrypted_memos: memos,
@@ -1911,7 +1912,7 @@ var ShieldedPoolModule = class {
       return {
         assetId: item.assetId,
         amount: item.amount.toString(),
-        commitment: import_polkadot_api2.Binary.fromHex(item.commitment),
+        commitment: item.commitment,
         encryptedMemo: item.encryptedMemo
       };
     });
@@ -1932,7 +1933,7 @@ var ShieldedPoolModule = class {
     EncryptedMemo.validate(params.encryptedMemo, "claimShieldedFees.encryptedMemo");
     const entry = resolveTx(this.substrate.unsafe, "ShieldedPool", "claim_shielded_fees");
     const tx = callUnsafeTx(entry, {
-      commitment: import_polkadot_api2.Binary.fromHex(params.commitment),
+      commitment: params.commitment,
       amount: params.amount,
       asset_id: params.assetId,
       encrypted_memo: params.encryptedMemo,

package/dist/index.mjs

@@ -242,12 +242,12 @@ var SubstrateClient = class _SubstrateClient {
     return this._papi.submitAndWatch(Binary.fromHex(signedHex));
   }
   /**
-   * Submits a bare (unsigned) extrinsic hex and waits for finalization.
+   * Submits a bare (unsigned) extrinsic and waits for finalization.
    * Used for gasless private_transfer and unshield transactions.
-   * The bare tx hex is produced by `tx.getBareTx()` from polkadot-api.
+   * The bare tx bytes are produced by `tx.getBareTx()` from polkadot-api.
    */
-  async submitUnsignedAndWatch(bareTxHex) {
-    return this._papi.submit(Binary.fromHex(bareTxHex));
+  async submitUnsignedAndWatch(bareTx) {
+    return this._papi.submit(bareTx);
   }
   /**
    * Convenience: wrap raw call bytes and sign+submit in one step.
@@ -638,6 +638,7 @@ function formatORB(raw, precision = 6) {
 }
 
 // src/evm-explorer/EvmExplorer.ts
+var MAX_LOG_BLOCK_RANGE = 1e3;
 var EvmExplorer = class _EvmExplorer {
   /** @param evm - Underlying `EvmClient` used for all RPC calls. */
   constructor(evm) {
@@ -747,11 +748,11 @@ var EvmExplorer = class _EvmExplorer {
   // --- Address ---
   /**
    * Returns aggregated on-chain data for an EVM address: balance, nonce,
-   * bytecode (truncated), and up to 50 recent logs from the last 5 000 blocks.
+   * bytecode (truncated), and up to 50 recent logs from the last 1 000 blocks.
    */
   async getAddressInfo(address) {
     const latest = await this.evm.getBlockNumber().catch(() => 0);
-    const fromBlock = `0x${Math.max(0, latest - 5e3).toString(16)}`;
+    const fromBlock = `0x${Math.max(0, latest - MAX_LOG_BLOCK_RANGE).toString(16)}`;
     const [balance, nonce, code, logs] = await Promise.all([
       this.evm.request("eth_getBalance", [address, "latest"]).catch(() => null),
       this.evm.getTransactionCount(address).catch(() => 0),
@@ -830,13 +831,13 @@ var EvmExplorer = class _EvmExplorer {
     };
   }
   /**
-   * Returns ERC-20 `Transfer` events for `address` from the last 5 000 blocks.
+   * Returns ERC-20 `Transfer` events for `address` from the last 1 000 blocks.
    * When `holderAddress` is provided, restricts results to transfers sent or received by that address.
    */
   async getTokenTransfers(address, holderAddress) {
     const TRANSFER = "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef";
     const latest = await this.evm.getBlockNumber().catch(() => 0);
-    const fromBlock = `0x${Math.max(0, latest - 5e3).toString(16)}`;
+    const fromBlock = `0x${Math.max(0, latest - MAX_LOG_BLOCK_RANGE).toString(16)}`;
     let logs;
     if (holderAddress) {
       const padded = `0x${holderAddress.replace(/^0x/, "").toLowerCase().padStart(64, "0")}`;
@@ -1238,7 +1239,7 @@ var IndexerClient = class {
 };
 
 // src/shielded-pool/pallet/ShieldedPoolModule.ts
-import { Binary as Binary2 } from "polkadot-api";
+import "polkadot-api";
 
 // src/utils/tx.ts
 function formatDispatchError(err) {
@@ -1271,8 +1272,8 @@ function callUnsafeTx(txEntry, ...args) {
   return txEntry(...args);
 }
 async function submitBareTx(tx, client) {
-  const bareTxHex = await tx.getBareTx();
-  const payload = await client.submitUnsignedAndWatch(bareTxHex);
+  const bareTx = await tx.getBareTx();
+  const payload = await client.submitUnsignedAndWatch(bareTx);
   return toTxResult(payload);
 }
 function resolveTx(unsafe, pallet, call) {
@@ -1694,7 +1695,7 @@ var ShieldedPoolModule = class {
     const tx = callUnsafeTx(entry, {
       asset_id: params.assetId,
       amount: params.amount,
-      commitment: Binary2.fromHex(params.commitment),
+      commitment: params.commitment,
       encrypted_memo: params.encryptedMemo
     });
     return toTxResult(
@@ -1721,13 +1722,13 @@ var ShieldedPoolModule = class {
     }
     const tx = callUnsafeTx(entry, {
       proof: params.proof,
-      merkle_root: Binary2.fromHex(params.merkleRoot),
-      nullifier: Binary2.fromHex(params.nullifier),
+      merkle_root: params.merkleRoot,
+      nullifier: params.nullifier,
       asset_id: params.assetId,
       amount: params.amount,
       recipient: recipientSs58,
       fee: params.fee ?? 0n,
-      change_commitment: Binary2.fromHex(changeCommitment),
+      change_commitment: changeCommitment,
       change_encrypted_memo: changeEncryptedMemo,
       relayer: void 0
       // Option<H160> — None for direct Substrate submissions
@@ -1746,8 +1747,8 @@ var ShieldedPoolModule = class {
    * Extrinsic: shieldedPool.privateTransfer(proof, merkleRoot, nullifiers, commitments, memos, assetId, fee)
    */
   async privateTransfer(params, signer, txOptions) {
-    const nullifiers = params.inputs.map((inp) => Binary2.fromHex(inp.nullifier));
-    const commitments = params.outputs.map((out) => Binary2.fromHex(out.commitment));
+    const nullifiers = params.inputs.map((inp) => inp.nullifier);
+    const commitments = params.outputs.map((out) => out.commitment);
     const memos = params.outputs.map((out, i) => {
       EncryptedMemo.validate(
         out.encryptedMemo,
@@ -1758,7 +1759,7 @@ var ShieldedPoolModule = class {
     const entry = resolveTx(this.substrate.unsafe, "ShieldedPool", "private_transfer");
     const tx = callUnsafeTx(entry, {
       proof: params.proof,
-      merkle_root: Binary2.fromHex(params.merkleRoot),
+      merkle_root: params.merkleRoot,
       nullifiers,
       commitments,
       encrypted_memos: memos,
@@ -1784,7 +1785,7 @@ var ShieldedPoolModule = class {
       return {
         assetId: item.assetId,
         amount: item.amount.toString(),
-        commitment: Binary2.fromHex(item.commitment),
+        commitment: item.commitment,
         encryptedMemo: item.encryptedMemo
       };
     });
@@ -1805,7 +1806,7 @@ var ShieldedPoolModule = class {
     EncryptedMemo.validate(params.encryptedMemo, "claimShieldedFees.encryptedMemo");
     const entry = resolveTx(this.substrate.unsafe, "ShieldedPool", "claim_shielded_fees");
     const tx = callUnsafeTx(entry, {
-      commitment: Binary2.fromHex(params.commitment),
+      commitment: params.commitment,
       amount: params.amount,
       asset_id: params.assetId,
       encrypted_memo: params.encryptedMemo,
@@ -1819,7 +1820,7 @@ var ShieldedPoolModule = class {
 };
 
 // src/account-mapping/AccountMappingModule.ts
-import { Binary as Binary3 } from "polkadot-api";
+import { Binary as Binary2 } from "polkadot-api";
 
 // src/account-mapping/helpers.ts
 function mapRawScheme(raw) {
@@ -2089,7 +2090,7 @@ var AccountMappingModule = class {
    */
   async registerAlias(alias, signer) {
     const entry = resolveTx(this.substrate.unsafe, "accountMapping", "registerAlias");
-    const tx = callUnsafeTx(entry, Binary3.fromText(alias));
+    const tx = callUnsafeTx(entry, Binary2.fromText(alias));
     return toTxResult(await tx.signAndSubmit(signer));
   }
   /**
@@ -2140,7 +2141,7 @@ var AccountMappingModule = class {
    */
   async setAccountMetadata(params, signer) {
     const entry = resolveTx(this.substrate.unsafe, "accountMapping", "setAccountMetadata");
-    const encode2 = (v) => v != null ? Binary3.fromText(v) : void 0;
+    const encode2 = (v) => v != null ? Binary2.fromText(v) : void 0;
     const tx = callUnsafeTx(
       entry,
       encode2(params.displayName),
@@ -2173,7 +2174,7 @@ var AccountMappingModule = class {
    */
   async buyAlias(alias, signer) {
     const entry = resolveTx(this.substrate.unsafe, "accountMapping", "buyAlias");
-    const tx = callUnsafeTx(entry, Binary3.fromText(alias));
+    const tx = callUnsafeTx(entry, Binary2.fromText(alias));
     return toTxResult(await tx.signAndSubmit(signer));
   }
   /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@orbinum/sdk",
-  "version": "0.7.1",
+  "version": "0.7.3",
   "description": "Official TypeScript SDK for Orbinum.",
   "author": "Orbinum",
   "license": "MIT",