voxelithic-interfaces 0.4.0 → 0.5.1

package/LICENSE

@@ -3,13 +3,19 @@ MIT License
 Copyright (c) 2026 Voxelithic
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files, to deal in the Software
-without restriction, including without limitation the rights to use, copy,
-modify, merge, publish, distribute, sublicense, and/or sell copies of the
-Software, and to permit persons to whom the Software is furnished to do so,
-subject to the following conditions:
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
 
 The above copyright notice and this permission notice shall be included in all
 copies or substantial portions of the Software.
 
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,5 +1,9 @@
 # voxelithic-interfaces
 
+[![CI](https://github.com/Voxelithicag/interfaces/actions/workflows/ci.yml/badge.svg)](https://github.com/Voxelithicag/interfaces/actions/workflows/ci.yml)
+[![npm](https://img.shields.io/npm/v/voxelithic-interfaces?color=0b0d10)](https://www.npmjs.com/package/voxelithic-interfaces)
+[![license](https://img.shields.io/badge/license-MIT-d4d9e1)](LICENSE)
+
 TypeScript types, contract ABIs and verified addresses for Voxelithic on Robinhood Chain (4663).
 
 ## Install
@@ -46,10 +50,26 @@ The full picture of what else carries these tickers is at
 | `ROUTER`, `QUOTER` | Uniswap v3 style venues, deployed and verified |
 | `ROUTER_V4`, `QUOTER_V4` | Uniswap v4 singleton branch |
 | `UNISWAP_V4_SINGLETON` | the v4 pool manager |
+| `TREASURY` | fee recipient; everything it receives is swapped into VOXEL and burned |
 | `TOKENS`, `SYMBOLS`, `addressOf` | canonical token set |
 | `VoxRouterABI`, `VoxQuoterABI`, `VoxRouterV4ABI`, `VoxQuoterV4ABI` | ABIs taken from the Foundry build artifacts, not retyped |
 | `Hop`, `Route`, `Quote`, `PoolKey` | request and response shapes |
 
+## Or skip the install
+
+The same routing is available over HTTP, with no package and no key:
+
+```bash
+curl 'https://voxelithic.xyz/api/v1/quote?tokenIn=USDG&tokenOut=SPY&amountIn=10'
+```
+
+`/tokens` and `/venues` mirror the exports above, `/quote` compares every direct
+pool that can actually take the size, `/swap` returns an unsigned transaction and
+`/verify` reads what a fill really did from its receipt.
+
+The API holds no keys and cannot broadcast. Spec and service level:
+[openapi.json](https://voxelithic.xyz/api/v1/openapi.json).
+
 ## Regenerating the token set
 
 ```bash
@@ -59,6 +79,18 @@ node scripts/gen-tokens.mjs /path/to/app/config.js
 Every address is verified against mainnet as it is written. The script exits
 non-zero and leaves the file untouched if anything fails.
 
+## Tests
+
+```bash
+npm test              # imports the built package and checks its shape
+npm run test:onchain  # every address in the package must exist on mainnet
+```
+
+The first suite runs against `dist`, not the sources, because that is where a
+published package actually breaks. The second one is why the addresses here can
+be trusted: an address with no contract, a mismatched symbol or wrong decimals
+fails the run. Both are wired into CI on every push.
+
 ## Contracts
 
 | Contract | Address |
@@ -67,8 +99,9 @@ non-zero and leaves the file untouched if anything fails.
 | VoxQuoter | `0x9616627E871c96e38cb21b9551F62Ed93366bE1B` |
 | VoxRouterV4 | `0x290b9b46308f7a3B80A5F62214B426d3bfAfaab5` |
 | VoxQuoterV4 | `0x5858F06894623eF4862103A747074E5AA3436d4F` |
+| VoxTreasury | `0xDfC6004E2a56de0e59007BFC4F3E3890a889af67` |
 
-All four are verified on
+All five are verified on
 [Blockscout](https://robinhoodchain.blockscout.com/address/0x87cD7EbE8c213455e5e5a8554657D5f294a82e64).
 
 ## License

package/dist/addresses.d.ts

@@ -4,3 +4,5 @@ export declare const QUOTER: "0x9616627E871c96e38cb21b9551F62Ed93366bE1B";
 export declare const ROUTER_V4: "0x290b9b46308f7a3B80A5F62214B426d3bfAfaab5";
 export declare const QUOTER_V4: "0x5858F06894623eF4862103A747074E5AA3436d4F";
 export declare const UNISWAP_V4_SINGLETON: "0xc851aDa1e4Fa2A9dd5483284d6b30e2950Cc4F04";
+/** Получатель комиссии. Всё, что сюда приходит, выкупает VOXEL и сжигает его. */
+export declare const TREASURY: "0xDfC6004E2a56de0e59007BFC4F3E3890a889af67";

package/dist/addresses.js

@@ -4,3 +4,5 @@ export const QUOTER = '0x9616627E871c96e38cb21b9551F62Ed93366bE1B';
 export const ROUTER_V4 = '0x290b9b46308f7a3B80A5F62214B426d3bfAfaab5';
 export const QUOTER_V4 = '0x5858F06894623eF4862103A747074E5AA3436d4F';
 export const UNISWAP_V4_SINGLETON = '0xc851aDa1e4Fa2A9dd5483284d6b30e2950Cc4F04';
+/** Получатель комиссии. Всё, что сюда приходит, выкупает VOXEL и сжигает его. */
+export const TREASURY = '0xDfC6004E2a56de0e59007BFC4F3E3890a889af67';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "voxelithic-interfaces",
-  "version": "0.4.0",
+  "version": "0.5.1",
   "description": "TypeScript types, contract ABIs and verified addresses for Voxelithic on Robinhood Chain (4663)",
   "keywords": [
     "robinhood-chain",
@@ -38,8 +38,10 @@
   "sideEffects": false,
   "scripts": {
     "build": "tsc",
+    "test": "node test/smoke.mjs",
+    "test:onchain": "node test/onchain.mjs",
     "gen:tokens": "node scripts/gen-tokens.mjs",
-    "prepublishOnly": "npm run build"
+    "prepublishOnly": "npm run build && npm test"
   },
   "devDependencies": {
     "typescript": "^5.6.0"

package/src/addresses.ts

@@ -5,3 +5,6 @@ export const QUOTER = '0x9616627E871c96e38cb21b9551F62Ed93366bE1B' as const
 export const ROUTER_V4 = '0x290b9b46308f7a3B80A5F62214B426d3bfAfaab5' as const
 export const QUOTER_V4 = '0x5858F06894623eF4862103A747074E5AA3436d4F' as const
 export const UNISWAP_V4_SINGLETON = '0xc851aDa1e4Fa2A9dd5483284d6b30e2950Cc4F04' as const
+
+/** Получатель комиссии. Всё, что сюда приходит, выкупает VOXEL и сжигает его. */
+export const TREASURY = '0xDfC6004E2a56de0e59007BFC4F3E3890a889af67' as const