@forevermoney/sdk 0.5.4 → 0.5.6

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## 0.5.6 — 2026-09-22
+
+- Add Pareton (SN10) deployment metadata on Base, Robinhood and Subtensor.
+- Support staked-only SN10 bridge plans and preparation in both directions
+  on both EVM spokes, enforcing netuid 10. Deployment version is 1.5.0.
+
+## 0.5.5 — 2026-09-21
+
+- Discover destination off-ramps from the canonical CCIP router for the source
+  chain, retaining the configured legacy off-ramp for historical transfers.
+  Cache discovery for five minutes per provider and coalesce concurrent reads.
+- Recognise both legacy and CCIP v2 execution events and select the latest
+  execution across off-ramps. This fixes completed Finney-to-Robinhood SN80
+  deliveries remaining in the waiting state. Verified against a real delivery.
+
 ## 0.5.4 — 2026-09-21
 
 - Added the canonical Robinhood SN80 token to deployment metadata and enabled

package/README.md

@@ -134,6 +134,21 @@ The bridge does not deduct its fee from the destination amount. For both
 directions, the SDK encodes the bridge amount itself as the contract's minimum
 output; callers cannot weaken that invariant.
 
+## Bridge Pareton (SN10)
+
+Use `asset: 'sn10'` with `evmChain: 'base'` or `'robinhood'` in the
+bridge plan and preparation APIs. Finney input and delivery must be staked;
+netuid defaults to 10 and any other netuid is rejected. Amounts use 18 decimals
+and must be whole alpha RAO. Approval, quoting and tracking use the same APIs
+as SN80 below.
+
+Canonical `contracts.wrappedSn10` addresses:
+
+- Base and Robinhood: `0xDdDE5965D49e69b6362BD8743e139a45dBFEb7b3`.
+- Subtensor (964): `0xcd0836D1ecE4AEDf5B39f2792e0790BBE79449b3`.
+
+The Subtensor ERC-20 remains named "Subnet 10"; the application displays Pareton.
+
 ## Bridge SN80 on Base and Robinhood
 
 Pass `asset: 'sn80'` to bridge Base or Robinhood SN80 to a Finney subnet-80

package/dist/index.cjs

@@ -37,6 +37,7 @@ __export(index_exports, {
   RAO_PER_TAO: () => RAO_PER_TAO,
   ROBINHOOD_CCIP_SELECTOR: () => ROBINHOOD_CCIP_SELECTOR,
   ROBINHOOD_CHAIN_ID: () => ROBINHOOD_CHAIN_ID,
+  SN10_NETUID: () => SN10_NETUID,
   SN80_NETUID: () => SN80_NETUID,
   SUBTENSOR_CCIP_SELECTOR: () => SUBTENSOR_CCIP_SELECTOR,
   SUBTENSOR_CHAIN_ID: () => SUBTENSOR_CHAIN_ID,
@@ -94,8 +95,9 @@ var ROBINHOOD_CCIP_SELECTOR = 6180753054346818345n;
 var SUBTENSOR_CCIP_SELECTOR = 2135107236357186872n;
 var RAO_PER_TAO = 1000000000n;
 var EVM_WEI_PER_RAO = 1000000000n;
+var SN10_NETUID = 10n;
 var SN80_NETUID = 80n;
-var FOREVERMONEY_DEPLOYMENT_VERSION = "1.4.0";
+var FOREVERMONEY_DEPLOYMENT_VERSION = "1.5.0";
 var foreverMoneyDeployment = Object.freeze({
   version: FOREVERMONEY_DEPLOYMENT_VERSION,
   base: Object.freeze({
@@ -113,6 +115,9 @@ var foreverMoneyDeployment = Object.freeze({
       wrappedTao: (0, import_viem.getAddress)(
         "0xf3081494b87e8d5fb7960f066e931d1d0e6e3d67"
       ),
+      wrappedSn10: (0, import_viem.getAddress)(
+        "0xDdDE5965D49e69b6362BD8743e139a45dBFEb7b3"
+      ),
       wrappedSn80: (0, import_viem.getAddress)(
         "0x6f63d869011f95274498023b4abfc00b30c34378"
       ),
@@ -148,6 +153,9 @@ var foreverMoneyDeployment = Object.freeze({
       wrappedTao: (0, import_viem.getAddress)(
         "0xf3081494B87e8D5fb7960f066E931D1D0e6E3d67"
       ),
+      wrappedSn10: (0, import_viem.getAddress)(
+        "0xDdDE5965D49e69b6362BD8743e139a45dBFEb7b3"
+      ),
       wrappedSn80: (0, import_viem.getAddress)(
         "0x6f63d869011f95274498023b4abfc00b30c34378"
       ),
@@ -177,6 +185,9 @@ var foreverMoneyDeployment = Object.freeze({
       wrappedTao: (0, import_viem.getAddress)(
         "0xC5b6C1632d34901239396F5E1BDe54B342900256"
       ),
+      wrappedSn10: (0, import_viem.getAddress)(
+        "0xcd0836D1ecE4AEDf5B39f2792e0790BBE79449b3"
+      ),
       wrappedSn80: (0, import_viem.getAddress)(
         "0xfD628dE75EF96f0A5C59659159C6cA81E0DC2222"
       ),
@@ -708,7 +719,8 @@ var CCIP_EXECUTION_ABI = Object.freeze([
   "event ExecutionStateChanged(uint64 indexed sourceChainSelector,uint64 indexed sequenceNumber,bytes32 indexed messageId,bytes32 messageHash,uint8 state,bytes returnData,uint256 gasUsed)"
 ]);
 var CCIP_ROUTER_ABI = Object.freeze([
-  "function isOffRamp(uint64 sourceChainSelector,address offRamp) view returns (bool)"
+  "function isOffRamp(uint64 sourceChainSelector,address offRamp) view returns (bool)",
+  "function getOffRamps() view returns ((uint64 sourceChainSelector,address offRamp)[])"
 ]);
 var foreverMoneyAbis = Object.freeze({
   alphaGateway: ALPHA_GATEWAY_ABI,
@@ -811,18 +823,19 @@ function assertPartnerFeeAllowed(fee, maxBps) {
   }
 }
 function bridgeAsset(evmChain, asset = "tao") {
-  if (asset !== "tao" && asset !== "sn80") {
+  if (asset !== "tao" && asset !== "sn80" && asset !== "sn10") {
     throw new ForeverMoneyError(
       "INVALID_TRANSACTION_PLAN",
-      'Asset must be "tao" or "sn80".'
+      'Asset must be "tao", "sn80", or "sn10".'
     );
   }
   const evm = getForeverMoneyEvmDeployment(evmChain);
-  return asset === "sn80" ? {
-    evmToken: evm.contracts.wrappedSn80,
-    subtensorToken: foreverMoneyDeployment.subtensor.contracts.wrappedSn80,
-    label: "SN80",
-    wrappedLabel: "SN80"
+  const tokenKey = asset === "sn10" ? "wrappedSn10" : "wrappedSn80";
+  return asset !== "tao" ? {
+    evmToken: evm.contracts[tokenKey],
+    subtensorToken: foreverMoneyDeployment.subtensor.contracts[tokenKey],
+    label: asset.toUpperCase(),
+    wrappedLabel: asset.toUpperCase()
   } : {
     evmToken: evm.contracts.wrappedTao,
     subtensorToken: foreverMoneyDeployment.subtensor.contracts.wrappedTao,
@@ -831,16 +844,17 @@ function bridgeAsset(evmChain, asset = "tao") {
   };
 }
 function assertAssetMode(asset, mode) {
-  if (asset === "sn80" && mode !== "staked") {
+  if ((asset === "sn80" || asset === "sn10") && mode !== "staked") {
     throw new ForeverMoneyError(
       "INVALID_TRANSACTION_PLAN",
-      "SN80 bridging requires staked subnet 80 input or delivery; liquid TAO conversion is not supported."
+      `${asset.toUpperCase()} bridging requires staked subnet ${asset === "sn10" ? SN10_NETUID : SN80_NETUID} input or delivery; liquid TAO conversion is not supported.`
     );
   }
 }
 function sourceNetuid(input) {
   if (input.source !== "staked") return void 0;
-  const netuid = input.netuid ?? (input.asset === "sn80" ? SN80_NETUID : void 0);
+  const assetNetuid = input.asset === "sn10" ? SN10_NETUID : input.asset === "sn80" ? SN80_NETUID : void 0;
+  const netuid = input.netuid ?? assetNetuid;
   if (netuid === void 0) {
     throw new ForeverMoneyError(
       "INVALID_TRANSACTION_PLAN",
@@ -848,10 +862,10 @@ function sourceNetuid(input) {
     );
   }
   assertNonNegativeAmount(netuid, "netuid");
-  if (input.asset === "sn80" && netuid !== SN80_NETUID) {
+  if (assetNetuid !== void 0 && netuid !== assetNetuid) {
     throw new ForeverMoneyError(
       "INVALID_TRANSACTION_PLAN",
-      "SN80 staking approvals must use netuid 80."
+      `${input.asset.toUpperCase()} staking approvals must use netuid ${assetNetuid}.`
     );
   }
   return netuid;
@@ -2072,6 +2086,41 @@ function bridgeMessageIdFromReceipt(direction, receipt) {
 // src/bridge/tracking.ts
 var ccipExecutionAbi = (0, import_viem11.parseAbi)(CCIP_EXECUTION_ABI);
 var alphaGatewayAbi2 = (0, import_viem11.parseAbi)(ALPHA_GATEWAY_ABI);
+var routerAbi = (0, import_viem11.parseAbi)(CCIP_ROUTER_ABI);
+var executionV2Abi = (0, import_viem11.parseAbi)([
+  "event ExecutionStateChanged(uint64 indexed sourceChainSelector,uint64 indexed sequenceNumber,bytes32 indexed messageId,uint8 state,bytes returnData)"
+]);
+var rampCache = /* @__PURE__ */ new WeakMap();
+function deliveryOffRamps(provider, client, router, selector, legacy) {
+  let cache = rampCache.get(provider);
+  if (!cache) {
+    cache = /* @__PURE__ */ new Map();
+    rampCache.set(provider, cache);
+  }
+  const key = `${router}:${selector}:${legacy}`;
+  const cached = cache.get(key);
+  if (cached && cached.expires > Date.now()) return cached.request;
+  const request = client.readContract({
+    address: router,
+    abi: routerAbi,
+    functionName: "getOffRamps"
+  }).then((ramps) => {
+    const addresses = /* @__PURE__ */ new Map([
+      [legacy.toLowerCase(), legacy]
+    ]);
+    for (const ramp of ramps) {
+      if (ramp.sourceChainSelector === selector)
+        addresses.set(ramp.offRamp.toLowerCase(), ramp.offRamp);
+    }
+    return [...addresses.values()];
+  });
+  const entry = { expires: Date.now() + 3e5, request };
+  cache.set(key, entry);
+  void request.catch(() => {
+    if (cache.get(key) === entry) cache.delete(key);
+  });
+  return request;
+}
 function destinationChainId(direction) {
   assertBridgeDirection(direction);
   const evm = getForeverMoneyEvmDeployment(
@@ -2185,13 +2234,29 @@ async function getCcipDeliveryStatus(provider, input) {
   const evmToSubtensor = isEvmToSubtensorDirection(input.direction);
   const sourceSelector = evmToSubtensor ? evm.ccipSelector : foreverMoneyDeployment.subtensor.ccipSelector;
   const offRamp = evmToSubtensor ? evmChain === "base" ? foreverMoneyDeployment.subtensor.contracts.ccipOffRampFromBase : foreverMoneyDeployment.subtensor.contracts.ccipOffRampFromRobinhood : evm.contracts.ccipOffRampFromSubtensor;
-  const logs = await client.getLogs({
-    address: offRamp,
-    fromBlock: BigInt(input.fromBlock),
-    toBlock: "latest",
-    event: ccipExecutionAbi[0],
-    args: { sourceChainSelector: sourceSelector, messageId },
-    strict: true
+  const offRamps = await deliveryOffRamps(
+    provider,
+    client,
+    evmToSubtensor ? foreverMoneyDeployment.subtensor.contracts.ccipRouter : evm.contracts.ccipRouter,
+    sourceSelector,
+    offRamp
+  );
+  const batches = await Promise.all(
+    [executionV2Abi[0], ccipExecutionAbi[0]].map(
+      (event) => client.getLogs({
+        address: offRamps.length === 1 ? offRamps[0] : [...offRamps],
+        fromBlock: BigInt(input.fromBlock),
+        toBlock: "latest",
+        event,
+        args: { sourceChainSelector: sourceSelector, messageId },
+        strict: true
+      })
+    )
+  );
+  const logs = batches.flat().sort((a, b) => {
+    const blockA = a.blockNumber ?? 0n;
+    const blockB = b.blockNumber ?? 0n;
+    return blockA === blockB ? (a.logIndex ?? 0) - (b.logIndex ?? 0) : blockA < blockB ? -1 : 1;
   });
   const latest = logs.at(-1);
   if (latest === void 0) return "waiting";