tapimo 0.15.0 → 0.18.0

package/src/internal/routes/Reconciliation.test.ts

@@ -825,12 +825,88 @@ describe('createTracker', () => {
         maxAmount: '0.049999',
         name: 'limit exceeded',
       },
+      {
+        billing: 'past_due',
+        delivered: 950_000n,
+        maxAmount: null,
+        commitment: '0.05',
+        name: 'pinned expense allowed despite revoked policy and billing',
+      },
+      {
+        billing: 'active',
+        delivered: 950_000n,
+        maxAmount: '10',
+        commitment: '0.049999',
+        name: 'pinned expense denied despite higher live cap',
+      },
       {
         billing: 'missing',
         delivered: 1_000_000n,
         maxAmount: null,
         name: 'provider delivered in full',
       },
+      {
+        billing: 'active',
+        delivered: 950_000n,
+        maxAmount: '0.05',
+        providerSubsidy: true,
+        name: 'legacy gap limit excludes upstream subsidy',
+      },
+      {
+        billing: 'active',
+        delivered: 950_000n,
+        maxAmount: '0.05',
+        commitment: '0.05',
+        providerSubsidy: true,
+        name: 'pinned expense limit includes upstream subsidy',
+      },
+      {
+        billing: 'active',
+        commitment: '0.05',
+        delivered: 1_000_000n,
+        fixedRate: '1:1',
+        maxAmount: '0.05',
+        name: 'fixed-rate fill records provider expenses',
+        providerSubsidy: true,
+      },
+      {
+        billing: 'active',
+        commitment: '0.05',
+        delivered: 950_000n,
+        fixedRate: '1:1',
+        maxAmount: '0.05',
+        name: 'fixed-rate shortfall requires reconciliation without a top-up',
+        providerSubsidy: true,
+      },
+      {
+        billing: 'active',
+        commitment: '0.05',
+        delivered: 0n,
+        fixedRate: '1:1',
+        maxAmount: '0.05',
+        missingHash: true,
+        name: 'fixed-rate success without destination hashes requires reconciliation',
+        providerSubsidy: true,
+      },
+      {
+        billing: 'active',
+        commitment: '0.05',
+        delivered: 0n,
+        fixedRate: '1:1',
+        maxAmount: '0.05',
+        name: 'fixed-rate success without matching transfers requires reconciliation',
+        providerSubsidy: true,
+      },
+      {
+        billing: 'active',
+        commitment: '0.05',
+        delivered: 0n,
+        fixedRate: '1:1',
+        maxAmount: '0.05',
+        name: 'fixed-rate pending output remains bridging',
+        providerSubsidy: true,
+        status: 'submitted',
+      },
     ] as const
     const sourceTransactionHashes = new Set(
       scenarios.map((_, index) => `0x${(index + 81).toString(16).repeat(32)}`),
@@ -858,14 +934,19 @@ describe('createTracker', () => {
           ? '0x100'
           : {
               blockNumber: '0x80',
-              logs: [
-                transferLog({
-                  amount: amount ?? 0n,
-                  recipient: source ? (sourceRecipients.get(hash ?? '') ?? '') : route.recipient,
-                  sender: `0x${'71'.repeat(20)}`,
-                  token: source ? route.sourceToken.address : route.destinationToken.address,
-                }),
-              ],
+              logs:
+                amount === 0n
+                  ? []
+                  : [
+                      transferLog({
+                        amount: amount ?? 0n,
+                        recipient: source
+                          ? (sourceRecipients.get(hash ?? '') ?? '')
+                          : route.recipient,
+                        sender: `0x${'71'.repeat(20)}`,
+                        token: source ? route.sourceToken.address : route.destinationToken.address,
+                      }),
+                    ],
               status: '0x1',
             }
       response.writeHead(200, { 'content-type': 'application/json' })
@@ -928,6 +1009,19 @@ describe('createTracker', () => {
           environment: 'production',
           orgId,
           providerOutputToken: route.destinationToken,
+          ...('commitment' in scenario
+            ? {
+                providerState: {
+                  ...('fixedRate' in scenario ? { fixedRate: scenario.fixedRate } : {}),
+                  routePolicy: {
+                    maxAmount: scenario.commitment,
+                    scope: { orgId, environment: 'production' },
+                    subsidyPayer: 'enterprise',
+                    versions: [1],
+                  },
+                },
+              }
+            : {}),
           snapshot: {
             address: depositAddress,
             destinationChain: route.destinationChain,
@@ -948,11 +1042,12 @@ describe('createTracker', () => {
           metrics,
           request: {
             createdAt: '2026-01-06T00:01:00.000Z',
-            destinationTransactionHashes: [destinationTransactionHash],
+            destinationTransactionHashes:
+              'missingHash' in scenario ? [] : [destinationTransactionHash],
             id: `subsidy-policy-request-${index}`,
             refundTransactionHashes: [],
             sourceTransactionHashes: [sourceTransactionHash],
-            ...(scenario.name === 'provider delivered in full'
+            ...(scenario.name === 'provider delivered in full' || 'providerSubsidy' in scenario
               ? {
                   subsidy: {
                     amount: {
@@ -966,7 +1061,7 @@ describe('createTracker', () => {
                   },
                 }
               : {}),
-            status: 'success',
+            status: 'status' in scenario ? scenario.status : 'success',
             updatedAt: '2026-01-06T00:02:00.000Z',
           },
           trigger: 'manual',
@@ -976,6 +1071,19 @@ describe('createTracker', () => {
           depositAddressId: address.id,
           sourceTransactionHash,
         })
+        if (scenario.name === 'legacy gap limit excludes upstream subsidy')
+          expect(record?.statusReason?.code).toBe('subsidy_failed') // Eligible; no settler configured.
+        if (scenario.name === 'pinned expense limit includes upstream subsidy')
+          expect(record?.statusReason?.code).toBe('routes_subsidy_limit_exceeded')
+        if ('fixedRate' in scenario) {
+          expect(record?.settlementTransactionHash).toBeNull()
+          expect(record?.providerSubsidy?.amount.baseUnits).toBe('23838')
+          if (scenario.delivered === 0n) {
+            expect(record?.status).toBe('status' in scenario ? 'bridging' : 'action-required')
+            expect(result.terminal).toBe(!('status' in scenario))
+            expect(record?.providerDeliveredAt).toBeNull()
+          }
+        }
         records.push({
           name: scenario.name,
           status: record?.status,
@@ -998,6 +1106,13 @@ describe('createTracker', () => {
             "billing_required",
             "billing_past_due",
             "routes_subsidy_limit_exceeded",
+            "unavailable",
+            "routes_subsidy_limit_exceeded",
+            "unavailable",
+            "routes_subsidy_limit_exceeded",
+            "underfilled",
+            "underfilled",
+            "underfilled",
           ],
           "records": [
             {
@@ -1005,7 +1120,7 @@ describe('createTracker', () => {
               "status": "action-required",
               "statusReason": {
                 "code": "routes_subsidy_not_enabled",
-                "message": "Routes subsidies are not enabled for this organization.",
+                "message": "Route subsidies are not enabled for this request. Contact Tempo to enable them, or use an API key from an organization with subsidies enabled.",
               },
               "subsidies": [],
               "subsidyAmount": null,
@@ -1016,7 +1131,7 @@ describe('createTracker', () => {
               "status": "action-required",
               "statusReason": {
                 "code": "billing_required",
-                "message": "Billing required.",
+                "message": "Active billing is required for enterprise-paid route subsidies. Set up billing for this organization, then retry.",
               },
               "subsidies": [],
               "subsidyAmount": null,
@@ -1044,6 +1159,28 @@ describe('createTracker', () => {
               "subsidyAmount": null,
               "terminal": false,
             },
+            {
+              "name": "pinned expense allowed despite revoked policy and billing",
+              "status": "action-required",
+              "statusReason": {
+                "code": "subsidy_failed",
+                "message": "Tempo subsidy settlement is unavailable.",
+              },
+              "subsidies": [],
+              "subsidyAmount": null,
+              "terminal": true,
+            },
+            {
+              "name": "pinned expense denied despite higher live cap",
+              "status": "action-required",
+              "statusReason": {
+                "code": "routes_subsidy_limit_exceeded",
+                "message": "The required subsidy exceeds the per-transaction limit.",
+              },
+              "subsidies": [],
+              "subsidyAmount": null,
+              "terminal": false,
+            },
             {
               "name": "provider delivered in full",
               "status": "completed",
@@ -1072,6 +1209,217 @@ describe('createTracker', () => {
               "subsidyAmount": null,
               "terminal": true,
             },
+            {
+              "name": "legacy gap limit excludes upstream subsidy",
+              "status": "action-required",
+              "statusReason": {
+                "code": "subsidy_failed",
+                "message": "Tempo subsidy settlement is unavailable.",
+              },
+              "subsidies": [
+                {
+                  "amount": {
+                    "baseUnits": "23838",
+                    "currency": "USD",
+                    "decimals": 6,
+                    "formatted": "0.023838",
+                  },
+                  "provider": "relay",
+                  "token": {
+                    "address": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
+                    "currency": "USD",
+                    "decimals": 6,
+                    "name": "USD Coin",
+                    "standard": "ERC-20",
+                    "symbol": "USDC",
+                    "tokenKey": "eip155:8453/erc20:0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
+                    "verified": true,
+                  },
+                },
+              ],
+              "subsidyAmount": null,
+              "terminal": true,
+            },
+            {
+              "name": "pinned expense limit includes upstream subsidy",
+              "status": "action-required",
+              "statusReason": {
+                "code": "routes_subsidy_limit_exceeded",
+                "message": "The required subsidy exceeds the per-transaction limit.",
+              },
+              "subsidies": [
+                {
+                  "amount": {
+                    "baseUnits": "23838",
+                    "currency": "USD",
+                    "decimals": 6,
+                    "formatted": "0.023838",
+                  },
+                  "provider": "relay",
+                  "token": {
+                    "address": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
+                    "currency": "USD",
+                    "decimals": 6,
+                    "name": "USD Coin",
+                    "standard": "ERC-20",
+                    "symbol": "USDC",
+                    "tokenKey": "eip155:8453/erc20:0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
+                    "verified": true,
+                  },
+                },
+              ],
+              "subsidyAmount": null,
+              "terminal": false,
+            },
+            {
+              "name": "fixed-rate fill records provider expenses",
+              "status": "completed",
+              "statusReason": null,
+              "subsidies": [
+                {
+                  "amount": {
+                    "baseUnits": "23838",
+                    "currency": "USD",
+                    "decimals": 6,
+                    "formatted": "0.023838",
+                  },
+                  "provider": "relay",
+                  "token": {
+                    "address": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
+                    "currency": "USD",
+                    "decimals": 6,
+                    "name": "USD Coin",
+                    "standard": "ERC-20",
+                    "symbol": "USDC",
+                    "tokenKey": "eip155:8453/erc20:0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
+                    "verified": true,
+                  },
+                },
+              ],
+              "subsidyAmount": null,
+              "terminal": true,
+            },
+            {
+              "name": "fixed-rate shortfall requires reconciliation without a top-up",
+              "status": "action-required",
+              "statusReason": {
+                "code": "subsidy_failed",
+                "message": "The provider completed without delivering the fixed-rate amount.",
+              },
+              "subsidies": [
+                {
+                  "amount": {
+                    "baseUnits": "23838",
+                    "currency": "USD",
+                    "decimals": 6,
+                    "formatted": "0.023838",
+                  },
+                  "provider": "relay",
+                  "token": {
+                    "address": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
+                    "currency": "USD",
+                    "decimals": 6,
+                    "name": "USD Coin",
+                    "standard": "ERC-20",
+                    "symbol": "USDC",
+                    "tokenKey": "eip155:8453/erc20:0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
+                    "verified": true,
+                  },
+                },
+              ],
+              "subsidyAmount": null,
+              "terminal": true,
+            },
+            {
+              "name": "fixed-rate success without destination hashes requires reconciliation",
+              "status": "action-required",
+              "statusReason": {
+                "code": "subsidy_failed",
+                "message": "The provider completed without delivering the fixed-rate amount.",
+              },
+              "subsidies": [
+                {
+                  "amount": {
+                    "baseUnits": "23838",
+                    "currency": "USD",
+                    "decimals": 6,
+                    "formatted": "0.023838",
+                  },
+                  "provider": "relay",
+                  "token": {
+                    "address": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
+                    "currency": "USD",
+                    "decimals": 6,
+                    "name": "USD Coin",
+                    "standard": "ERC-20",
+                    "symbol": "USDC",
+                    "tokenKey": "eip155:8453/erc20:0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
+                    "verified": true,
+                  },
+                },
+              ],
+              "subsidyAmount": null,
+              "terminal": true,
+            },
+            {
+              "name": "fixed-rate success without matching transfers requires reconciliation",
+              "status": "action-required",
+              "statusReason": {
+                "code": "subsidy_failed",
+                "message": "The provider completed without delivering the fixed-rate amount.",
+              },
+              "subsidies": [
+                {
+                  "amount": {
+                    "baseUnits": "23838",
+                    "currency": "USD",
+                    "decimals": 6,
+                    "formatted": "0.023838",
+                  },
+                  "provider": "relay",
+                  "token": {
+                    "address": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
+                    "currency": "USD",
+                    "decimals": 6,
+                    "name": "USD Coin",
+                    "standard": "ERC-20",
+                    "symbol": "USDC",
+                    "tokenKey": "eip155:8453/erc20:0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
+                    "verified": true,
+                  },
+                },
+              ],
+              "subsidyAmount": null,
+              "terminal": true,
+            },
+            {
+              "name": "fixed-rate pending output remains bridging",
+              "status": "bridging",
+              "statusReason": null,
+              "subsidies": [
+                {
+                  "amount": {
+                    "baseUnits": "23838",
+                    "currency": "USD",
+                    "decimals": 6,
+                    "formatted": "0.023838",
+                  },
+                  "provider": "relay",
+                  "token": {
+                    "address": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
+                    "currency": "USD",
+                    "decimals": 6,
+                    "name": "USD Coin",
+                    "standard": "ERC-20",
+                    "symbol": "USDC",
+                    "tokenKey": "eip155:8453/erc20:0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
+                    "verified": true,
+                  },
+                },
+              ],
+              "subsidyAmount": null,
+              "terminal": false,
+            },
           ],
         }
       `)
@@ -3724,6 +4072,16 @@ describe('createTracker', () => {
           destinationToken: route.destinationToken,
           recipient: route.recipient,
           refundAddress,
+          request: {
+            createdAt: '2026-01-04T00:01:00.000Z',
+            destinationTransactionHashes: [],
+            id: 'relay-uncorrelated-request',
+            providerState: { relay: { orderId, solver } },
+            refundTransactionHashes: [],
+            sourceTransactionHashes: [sourceTransactionHash],
+            status: 'pending',
+            updatedAt: '2026-01-04T00:02:00.000Z',
+          },
           source: { amount: '1000000', transactionHash: sourceTransactionHash },
           sourceChain: route.sourceChain,
           sourceToken: route.sourceToken,