@spicenet-io/spiceflow-core 0.1.3 → 0.3.0

package/README.md

@@ -0,0 +1,82 @@
+# @spicenet-io/spiceflow-core
+
+Single source of truth for chain configs, token lists, logos, ABIs, and shared utilities across spiceflow repos.
+
+## Install
+
+```
+npm install @spicenet-io/spiceflow-core
+```
+
+## What's in here
+
+### Chains
+
+`CHAINS` is a record of all supported chains keyed by chain ID. Each entry has id, name, display name, network (mainnet/testnet), native currency, delegate contract address, block explorer, rpc url, and logo.
+
+Helper functions: `getChainMeta(chainId)`, `getChainsByNetwork(network)`, `getChainIdsByNetwork(network)`, `getMainnetChains()`, `getTestnetChains()`, `getDelegateContract(chainId)`.
+
+### Tokens
+
+`TOKENS` is the official token list. Each token has symbol, name, equivalence group, logo, and deployments across chains (address, decimals, network per chain).
+
+Helper functions: `getTokensForChain(chainId)`, `getTokenByAddress(address, chainId)`, `getEquivalentAddresses(tokenAddress)`, `areEquivalent(a, b)`, `isUsdDenominated(address)`, `isBtcDenominated(address)`.
+
+### Logos
+
+All chain and token logos are bundled as base64 data URIs in the package. They work directly in img src attributes with no network requests. To add a new logo, drop the PNG in `logos/` and reference it in the chain or token list. `npm run build` auto generates the base64 file.
+
+### Utilities
+
+`isNativeToken(address)` checks if an address is a native token (zero address, 0x0, or 0xeee...eee).
+
+`normalizeNativeTokenAddress(address)` normalizes any native token address to the zero address.
+
+`convertAmountBetweenDecimals(amount, fromDecimals, toDecimals)` converts token amounts between different decimal precisions.
+
+`formatTokenAmount(amount, decimals)` formats a bigint token amount into a human readable string.
+
+`truncateAddress(address)` shortens an address for display.
+
+`withRetry(fn, maxRetries, delayMs)` retries an async function with exponential backoff.
+
+Constants: `NATIVE_TOKEN_ADDRESS`, `ZERO_ADDRESS`, `ESCROW_ADDRESS`.
+
+### ABIs
+
+`DELEGATE_ABI`, `ERC20_ABI`, `WCBTC_ABI`.
+
+### Authorization
+
+`hashChainBatches(chainCalls)` hashes chain call batches for intent signing.
+
+`getIntentHash(signatureType, nbf, exp, chainBatches)` computes the intent hash.
+
+`getAccountNonce(address, publicClient)` gets the account nonce from chain.
+
+### Core SDK
+
+`SpiceFlowCore` class for building and submitting intents. Handles delegation signing, chain batch construction, intent signing, and transaction submission.
+
+### HTTP
+
+`fetchWithRetry(url, init, opts)` is a fetch wrapper with retry and exponential backoff.
+
+`submitTransaction(baseUrl, request)` submits a transaction to the relayer API.
+
+`getIntentStepStatus(txApiUrl, intentId, stepId)` checks intent execution status.
+
+`prepareRFQT(txApiUrl, request)` prepares an RFQT quote.
+
+## Adding a token
+
+1. Drop the logo PNG in `logos/`
+2. Add the token entry in `src/tokens/list.ts` with symbol, name, equivalence group, logo reference, and deployments
+3. `npm run build` and publish
+
+## Adding a chain
+
+1. Drop the logo PNG in `logos/` if it's a new chain logo
+2. Add the chain entry in `src/chains/list.ts`
+3. Add token deployments on that chain in `src/tokens/list.ts`
+4. `npm run build` and publish

package/dist/abis/delegate.d.ts

@@ -0,0 +1,419 @@
+export declare const DELEGATE_ABI: readonly [{
+    readonly type: "fallback";
+    readonly stateMutability: "payable";
+}, {
+    readonly type: "receive";
+    readonly stateMutability: "payable";
+}, {
+    readonly type: "function";
+    readonly name: "execute";
+    readonly inputs: readonly [{
+        readonly name: "intent";
+        readonly type: "tuple";
+        readonly internalType: "struct Delegate.Intent";
+        readonly components: readonly [{
+            readonly name: "signatureType";
+            readonly type: "string";
+            readonly internalType: "string";
+        }, {
+            readonly name: "signature";
+            readonly type: "bytes";
+            readonly internalType: "bytes";
+        }, {
+            readonly name: "nbf";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "exp";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "chainBatches";
+            readonly type: "tuple[]";
+            readonly internalType: "struct Delegate.ChainBatch[]";
+            readonly components: readonly [{
+                readonly name: "hash";
+                readonly type: "bytes32";
+                readonly internalType: "bytes32";
+            }, {
+                readonly name: "chainId";
+                readonly type: "uint256";
+                readonly internalType: "uint256";
+            }, {
+                readonly name: "calls";
+                readonly type: "tuple[]";
+                readonly internalType: "struct Delegate.Call[]";
+                readonly components: readonly [{
+                    readonly name: "to";
+                    readonly type: "address";
+                    readonly internalType: "address";
+                }, {
+                    readonly name: "value";
+                    readonly type: "uint256";
+                    readonly internalType: "uint256";
+                }, {
+                    readonly name: "data";
+                    readonly type: "bytes";
+                    readonly internalType: "bytes";
+                }];
+            }];
+        }];
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "payable";
+}, {
+    readonly type: "function";
+    readonly name: "selfExecute";
+    readonly inputs: readonly [{
+        readonly name: "calls";
+        readonly type: "tuple[]";
+        readonly internalType: "struct Delegate.Call[]";
+        readonly components: readonly [{
+            readonly name: "to";
+            readonly type: "address";
+            readonly internalType: "address";
+        }, {
+            readonly name: "value";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "data";
+            readonly type: "bytes";
+            readonly internalType: "bytes";
+        }];
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "payable";
+}, {
+    readonly type: "function";
+    readonly name: "isChainBatchProcessed";
+    readonly inputs: readonly [{
+        readonly name: "chainBatchHash";
+        readonly type: "bytes32";
+        readonly internalType: "bytes32";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+        readonly internalType: "bool";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "normalizeIntentAndComputeHash";
+    readonly inputs: readonly [{
+        readonly name: "userIntent";
+        readonly type: "tuple";
+        readonly internalType: "struct Delegate.Intent";
+        readonly components: readonly [{
+            readonly name: "signatureType";
+            readonly type: "string";
+            readonly internalType: "string";
+        }, {
+            readonly name: "signature";
+            readonly type: "bytes";
+            readonly internalType: "bytes";
+        }, {
+            readonly name: "nbf";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "exp";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "chainBatches";
+            readonly type: "tuple[]";
+            readonly internalType: "struct Delegate.ChainBatch[]";
+            readonly components: readonly [{
+                readonly name: "hash";
+                readonly type: "bytes32";
+                readonly internalType: "bytes32";
+            }, {
+                readonly name: "chainId";
+                readonly type: "uint256";
+                readonly internalType: "uint256";
+            }, {
+                readonly name: "calls";
+                readonly type: "tuple[]";
+                readonly internalType: "struct Delegate.Call[]";
+                readonly components: readonly [{
+                    readonly name: "to";
+                    readonly type: "address";
+                    readonly internalType: "address";
+                }, {
+                    readonly name: "value";
+                    readonly type: "uint256";
+                    readonly internalType: "uint256";
+                }, {
+                    readonly name: "data";
+                    readonly type: "bytes";
+                    readonly internalType: "bytes";
+                }];
+            }];
+        }];
+    }];
+    readonly outputs: readonly [{
+        readonly name: "intent";
+        readonly type: "tuple";
+        readonly internalType: "struct Delegate.Intent";
+        readonly components: readonly [{
+            readonly name: "signatureType";
+            readonly type: "string";
+            readonly internalType: "string";
+        }, {
+            readonly name: "signature";
+            readonly type: "bytes";
+            readonly internalType: "bytes";
+        }, {
+            readonly name: "nbf";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "exp";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "chainBatches";
+            readonly type: "tuple[]";
+            readonly internalType: "struct Delegate.ChainBatch[]";
+            readonly components: readonly [{
+                readonly name: "hash";
+                readonly type: "bytes32";
+                readonly internalType: "bytes32";
+            }, {
+                readonly name: "chainId";
+                readonly type: "uint256";
+                readonly internalType: "uint256";
+            }, {
+                readonly name: "calls";
+                readonly type: "tuple[]";
+                readonly internalType: "struct Delegate.Call[]";
+                readonly components: readonly [{
+                    readonly name: "to";
+                    readonly type: "address";
+                    readonly internalType: "address";
+                }, {
+                    readonly name: "value";
+                    readonly type: "uint256";
+                    readonly internalType: "uint256";
+                }, {
+                    readonly name: "data";
+                    readonly type: "bytes";
+                    readonly internalType: "bytes";
+                }];
+            }];
+        }];
+    }, {
+        readonly name: "hash";
+        readonly type: "bytes32";
+        readonly internalType: "bytes32";
+    }];
+    readonly stateMutability: "pure";
+}, {
+    readonly type: "event";
+    readonly name: "BatchExecuted";
+    readonly inputs: readonly [{
+        readonly name: "block";
+        readonly type: "uint256";
+        readonly indexed: true;
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "calls";
+        readonly type: "tuple[]";
+        readonly indexed: false;
+        readonly internalType: "struct Delegate.Call[]";
+        readonly components: readonly [{
+            readonly name: "to";
+            readonly type: "address";
+            readonly internalType: "address";
+        }, {
+            readonly name: "value";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "data";
+            readonly type: "bytes";
+            readonly internalType: "bytes";
+        }];
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "CallExecuted";
+    readonly inputs: readonly [{
+        readonly name: "executor";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }, {
+        readonly name: "sender";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }, {
+        readonly name: "to";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }, {
+        readonly name: "value";
+        readonly type: "uint256";
+        readonly indexed: false;
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "data";
+        readonly type: "bytes";
+        readonly indexed: false;
+        readonly internalType: "bytes";
+    }, {
+        readonly name: "returnData";
+        readonly type: "bytes";
+        readonly indexed: false;
+        readonly internalType: "bytes";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "IntentSubmitted";
+    readonly inputs: readonly [{
+        readonly name: "signature";
+        readonly type: "bytes";
+        readonly indexed: true;
+        readonly internalType: "bytes";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "error";
+    readonly name: "CallReverted";
+    readonly inputs: readonly [{
+        readonly name: "account";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "to";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "value";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "data";
+        readonly type: "bytes";
+        readonly internalType: "bytes";
+    }, {
+        readonly name: "errorMessage";
+        readonly type: "bytes";
+        readonly internalType: "bytes";
+    }];
+}, {
+    readonly type: "error";
+    readonly name: "DuplicateChainBatch";
+    readonly inputs: readonly [{
+        readonly name: "intentSignature";
+        readonly type: "bytes";
+        readonly internalType: "bytes";
+    }, {
+        readonly name: "chainBatchHash";
+        readonly type: "bytes32";
+        readonly internalType: "bytes32";
+    }, {
+        readonly name: "chainBatchId";
+        readonly type: "bytes32";
+        readonly internalType: "bytes32";
+    }];
+}, {
+    readonly type: "error";
+    readonly name: "ECDSAInvalidSignature";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "ECDSAInvalidSignatureLength";
+    readonly inputs: readonly [{
+        readonly name: "length";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+}, {
+    readonly type: "error";
+    readonly name: "ECDSAInvalidSignatureS";
+    readonly inputs: readonly [{
+        readonly name: "s";
+        readonly type: "bytes32";
+        readonly internalType: "bytes32";
+    }];
+}, {
+    readonly type: "error";
+    readonly name: "IntentExpired";
+    readonly inputs: readonly [{
+        readonly name: "currentTime";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "exp";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+}, {
+    readonly type: "error";
+    readonly name: "IntentTooEarly";
+    readonly inputs: readonly [{
+        readonly name: "currentTime";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "nbf";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+}, {
+    readonly type: "error";
+    readonly name: "InvalidAuthority";
+    readonly inputs: readonly [{
+        readonly name: "actual";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "expected";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+}, {
+    readonly type: "error";
+    readonly name: "InvalidChainId";
+    readonly inputs: readonly [{
+        readonly name: "actual";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "expected";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+}, {
+    readonly type: "error";
+    readonly name: "InvalidSignature";
+    readonly inputs: readonly [{
+        readonly name: "signatureType";
+        readonly type: "string";
+        readonly internalType: "string";
+    }, {
+        readonly name: "recovered";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "expected";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+}, {
+    readonly type: "error";
+    readonly name: "InvalidSignatureType";
+    readonly inputs: readonly [{
+        readonly name: "signatureType";
+        readonly type: "string";
+        readonly internalType: "string";
+    }];
+}];
+//# sourceMappingURL=delegate.d.ts.map

package/dist/abis/delegate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delegate.d.ts","sourceRoot":"","sources":["../../src/abis/delegate.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqQf,CAAC"}

package/dist/abis/erc20.d.ts

@@ -0,0 +1,130 @@
+export declare const ERC20_ABI: readonly [{
+    readonly inputs: readonly [];
+    readonly name: "name";
+    readonly outputs: readonly [{
+        readonly type: "string";
+    }];
+    readonly stateMutability: "view";
+    readonly type: "function";
+}, {
+    readonly inputs: readonly [];
+    readonly name: "symbol";
+    readonly outputs: readonly [{
+        readonly type: "string";
+    }];
+    readonly stateMutability: "view";
+    readonly type: "function";
+}, {
+    readonly inputs: readonly [];
+    readonly name: "decimals";
+    readonly outputs: readonly [{
+        readonly type: "uint8";
+    }];
+    readonly stateMutability: "view";
+    readonly type: "function";
+}, {
+    readonly inputs: readonly [{
+        readonly name: "account";
+        readonly type: "address";
+    }];
+    readonly name: "balanceOf";
+    readonly outputs: readonly [{
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+    readonly type: "function";
+}, {
+    readonly inputs: readonly [{
+        readonly name: "to";
+        readonly type: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+    }];
+    readonly name: "transfer";
+    readonly outputs: readonly [{
+        readonly type: "bool";
+    }];
+    readonly stateMutability: "nonpayable";
+    readonly type: "function";
+}, {
+    readonly inputs: readonly [{
+        readonly name: "from";
+        readonly type: "address";
+    }, {
+        readonly name: "to";
+        readonly type: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+    }];
+    readonly name: "transferFrom";
+    readonly outputs: readonly [{
+        readonly type: "bool";
+    }];
+    readonly stateMutability: "nonpayable";
+    readonly type: "function";
+}, {
+    readonly inputs: readonly [{
+        readonly name: "spender";
+        readonly type: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+    }];
+    readonly name: "approve";
+    readonly outputs: readonly [{
+        readonly type: "bool";
+    }];
+    readonly stateMutability: "nonpayable";
+    readonly type: "function";
+}, {
+    readonly inputs: readonly [{
+        readonly name: "owner";
+        readonly type: "address";
+    }, {
+        readonly name: "spender";
+        readonly type: "address";
+    }];
+    readonly name: "allowance";
+    readonly outputs: readonly [{
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+    readonly type: "function";
+}, {
+    readonly anonymous: false;
+    readonly inputs: readonly [{
+        readonly indexed: true;
+        readonly name: "from";
+        readonly type: "address";
+    }, {
+        readonly indexed: true;
+        readonly name: "to";
+        readonly type: "address";
+    }, {
+        readonly indexed: false;
+        readonly name: "value";
+        readonly type: "uint256";
+    }];
+    readonly name: "Transfer";
+    readonly type: "event";
+}, {
+    readonly anonymous: false;
+    readonly inputs: readonly [{
+        readonly indexed: true;
+        readonly name: "owner";
+        readonly type: "address";
+    }, {
+        readonly indexed: true;
+        readonly name: "spender";
+        readonly type: "address";
+    }, {
+        readonly indexed: false;
+        readonly name: "value";
+        readonly type: "uint256";
+    }];
+    readonly name: "Approval";
+    readonly type: "event";
+}];
+//# sourceMappingURL=erc20.d.ts.map

package/dist/abis/erc20.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"erc20.d.ts","sourceRoot":"","sources":["../../src/abis/erc20.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAWZ,CAAC"}

package/dist/abis/index.d.ts

@@ -0,0 +1,5 @@
+export { DELEGATE_ABI } from "./delegate.js";
+export { ERC20_ABI } from "./erc20.js";
+export { WCBTC_ABI } from "./wcbtc.js";
+export { uniV3QuoterV2Abi, uniV3SwapRouterAbi } from "./uniV3.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/abis/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/abis/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC"}