@oikos/core-addresses 0.1.0

package/README.md

@@ -0,0 +1,157 @@
+# @oikos/core-addresses
+
+Programmatic access to Oikos Protocol contract addresses by chain id or network name.
+
+Deployment data is bundled from a pinned release tag of [`oikos-cash/core`](https://github.com/oikos-cash/core), so installing a fixed version of this package gives you a frozen, offline snapshot of the addresses for that protocol release.
+
+## Install
+
+```sh
+npm install @oikos/core-addresses
+# or
+pnpm add @oikos/core-addresses
+# or
+yarn add @oikos/core-addresses
+```
+
+## Programmatic usage
+
+```ts
+import {
+  getAddress,
+  getAddresses,
+  getSupportedNetworks,
+  isSupported,
+  SOURCE_TAG,
+} from "@oikos/core-addresses";
+
+// By chain id
+const vault = getAddress(56, "Vault");
+
+// By name or alias (case-insensitive: bsc, bnb, binance, bnbchain, ...)
+const pool = getAddress("bsc", "Pool");
+
+// Full address map for a network
+const addrs = getAddresses("bnb");
+// {
+//   Vault: "0x...",
+//   Pool:  "0x...",
+//   ...
+// }
+
+isSupported(56);      // true
+isSupported(1);       // false
+SOURCE_TAG;           // "v0.1"  — pinned protocol release
+getSupportedNetworks();
+```
+
+CommonJS also works:
+
+```js
+const { getAddress } = require("@oikos/core-addresses");
+```
+
+### API
+
+| Export | Description |
+| --- | --- |
+| `getAddresses(network)` | Returns a copy of the full `{ contract: address }` map for the network. Throws if unknown. |
+| `getAddress(network, contract)` | Returns a single address. Throws if the network or contract is unknown. |
+| `isSupported(network)` | `true` if the network has a bundled deployment. |
+| `getSupportedNetworks()` | List of `{ chainId, name, aliases }` for networks with deployments. |
+| `getNetworkInfo(network)` | Resolves any identifier to its `NetworkInfo`, or `undefined`. |
+| `deployment` | Raw `{ chainId: { contract: address } }` map. |
+| `NETWORKS` | All known network metadata (including networks without deployments yet). |
+| `getSourceMeta()` | `{ tag, source, fetchedAt, sha256 }` for the bundled snapshot. |
+| `SOURCE_TAG` / `SOURCE_URL` / `FETCHED_AT` / `SOURCE_SHA256` | Same values as above, as top-level constants. |
+
+`network` can be a number (`56`), a numeric string (`"56"`), the canonical name (`"bsc"`), or any registered alias (`"bnb"`, `"binance"`, `"bnbchain"`, `"bsc-mainnet"`, `"bnb-mainnet"`). Names are case-insensitive.
+
+### Types
+
+```ts
+type NetworkInfo = {
+  chainId: number;
+  name: string;
+  aliases: readonly string[];
+};
+
+type ContractAddresses = Record<string, string>;
+type Deployment = Record<string, ContractAddresses>;
+
+type SourceMeta = {
+  tag: string;        // e.g. "v0.1"
+  source: string;     // raw.githubusercontent URL the data was fetched from
+  fetchedAt: string;  // ISO-8601 timestamp
+  sha256: string;     // sha256 of the fetched bytes
+};
+```
+
+## CLI (`npx`)
+
+```sh
+npx @oikos/core-addresses 56
+npx @oikos/core-addresses bsc
+npx @oikos/core-addresses bsc Vault
+npx @oikos/core-addresses --list
+npx @oikos/core-addresses --json bsc
+```
+
+| Flag | Effect |
+| --- | --- |
+| `-h, --help` | Show usage. |
+| `-l, --list` | List supported networks plus the bundled source tag and sha256. |
+| `-j, --json` | Print compact single-line JSON instead of pretty-printed. |
+
+Exit code is `1` on unknown network or unknown contract.
+
+## Supported networks
+
+| chainId | name | aliases |
+| --- | --- | --- |
+| 56 | `bsc` | `bnb`, `binance`, `bnbchain`, `bsc-mainnet`, `bnb-mainnet` |
+
+Adding a new network: append an entry to [`src/networks.ts`](src/networks.ts) and make sure the chain id is present in the source `deployment.json`.
+
+## How the deployment data is pinned
+
+This package does not check its address data into git. Instead, on every build it fetches the canonical `deployment.json` from a pinned ref of `oikos-cash/core`:
+
+```
+https://raw.githubusercontent.com/oikos-cash/core/${oikosCoreTag}/deploy_helper/out/deployment.json
+```
+
+The fetched bytes (plus tag, URL, timestamp, and sha256) are bundled into `dist/` and re-exported from the library, so consumers can verify which protocol release they are running against.
+
+- The pin lives in [`package.json`](package.json) under `"oikosCoreTag"` (default `v0.1`).
+- It can be overridden ad-hoc via the `OIKOS_CORE_TAG` env var or a positional arg to the fetch script.
+- Network access is required at **build/publish time only**. End consumers installing from npm get a fully bundled, offline-capable package.
+
+### Bumping the pinned protocol release
+
+1. Edit `oikosCoreTag` in `package.json` to the new tag (e.g. `v0.2`).
+2. Bump the npm `version` in `package.json` to match.
+3. `npm run build` — re-fetches from the new ref and re-bundles.
+4. `npm publish --access public`.
+
+Or as a one-off without changing the default:
+
+```sh
+OIKOS_CORE_TAG=v0.2 npm run build
+```
+
+## Development
+
+```sh
+npm install
+npm run fetch-deployment   # writes data/deployment.json + data/meta.json
+npm run build              # tsup → dist/{index,cli}.{js,cjs,d.ts,d.cts}
+npm test                   # node:test against the built bundle
+npm run typecheck          # tsc --noEmit
+```
+
+`npm install` runs `prepare`, which runs the fetch + build pipeline automatically, so a fresh clone is ready to use immediately (network is required on first install in order to fetch the pinned deployment data).
+
+## License
+
+MIT.

package/dist/cli.cjs

@@ -0,0 +1,157 @@
+#!/usr/bin/env node
+"use strict";
+
+// data/deployment.json
+var deployment_default = {
+  "56": {
+    Vault: "0x6D77a715d2047a69DFdf922876712c4ef17d1788",
+    Pool: "0x104bab30b2983df47dd504114353B0A73bF663CE",
+    Proxy: "0x614da16Af43A8Ad0b9F419Ab78d14D163DEa6488",
+    ExchangeHelper: "0xe9490B6AA9e3847636CD491f9962Ab2658E589F6",
+    ModelHelper: "0x0b94E3c636C967e1e169faeb268C2ca741E9987A",
+    AdaptiveSupply: "0xd0581Ba58A5970F83ac1F2f23be09202db96303d",
+    RewardsCalculator: "0x88F83ab63ccf9129Cbb681145F879790d29cC4e6",
+    Resolver: "0xa78142B2A829AbA5D737af86a14d2BeEE82dDcF9",
+    Factory: "0x9F5973EC7E5f0781E0fCE71Dd949c997c38508Fc"
+  }
+};
+
+// data/meta.json
+var meta_default = {
+  tag: "v0.1",
+  source: "https://raw.githubusercontent.com/oikos-cash/core/v0.1/deploy_helper/out/deployment.json",
+  fetchedAt: "2026-05-16T19:38:51.457Z",
+  sha256: "5e593341d02a2e9f935d0b234401090c6e858a654fed307ad3ccef83d6fedbb7"
+};
+
+// src/networks.ts
+var NETWORKS = [
+  {
+    chainId: 56,
+    name: "bsc",
+    aliases: ["bsc", "bnb", "binance", "bnbchain", "bsc-mainnet", "bnb-mainnet"]
+  }
+];
+
+// src/index.ts
+var deployment = deployment_default;
+var meta = meta_default;
+var SOURCE_TAG = meta.tag;
+var SOURCE_URL = meta.source;
+var FETCHED_AT = meta.fetchedAt;
+var SOURCE_SHA256 = meta.sha256;
+function resolveChainId(network) {
+  if (typeof network === "number") {
+    if (!Number.isFinite(network) || !Number.isInteger(network)) {
+      throw new Error(`Invalid chain id: ${network}`);
+    }
+    return network;
+  }
+  const s = String(network).toLowerCase().trim();
+  if (s === "") throw new Error("Network identifier is empty");
+  if (/^\d+$/.test(s)) return Number.parseInt(s, 10);
+  const match = NETWORKS.find(
+    (n) => n.name === s || n.aliases.includes(s)
+  );
+  if (!match) {
+    const known = NETWORKS.map((n) => `${n.chainId} (${n.name})`).join(", ");
+    throw new Error(`Unknown network: "${network}". Known: ${known}`);
+  }
+  return match.chainId;
+}
+function getAddresses(network) {
+  const chainId = resolveChainId(network);
+  const addrs = deployment[String(chainId)];
+  if (!addrs) {
+    throw new Error(`No deployment found for chain id ${chainId}`);
+  }
+  return { ...addrs };
+}
+function getAddress(network, contract) {
+  const addrs = getAddresses(network);
+  const addr = addrs[contract];
+  if (!addr) {
+    throw new Error(
+      `Contract "${contract}" not deployed on network ${network}`
+    );
+  }
+  return addr;
+}
+function getSupportedNetworks() {
+  return NETWORKS.filter(
+    (n) => deployment[String(n.chainId)] !== void 0
+  ).map((n) => ({ ...n, aliases: [...n.aliases] }));
+}
+
+// src/cli.ts
+var HELP = `Usage: oikos-addresses <network> [contract]
+
+Print Oikos Protocol contract addresses for a given network.
+
+Arguments:
+  network    Chain id (e.g. 56) or network name (e.g. bsc, bnb, binance)
+  contract   Optional contract name (e.g. Vault). If omitted, prints all.
+
+Examples:
+  oikos-addresses 56
+  oikos-addresses bsc
+  oikos-addresses bsc Vault
+  oikos-addresses --list
+  oikos-addresses --json bsc
+
+Options:
+  -h, --help    Show this help
+  -l, --list    List supported networks
+  -j, --json    Output a single-line JSON (default is pretty-printed JSON)
+`;
+function printNetworks() {
+  const rows = getSupportedNetworks().map((n) => ({
+    chainId: n.chainId,
+    name: n.name,
+    aliases: n.aliases.join(", ")
+  }));
+  console.log(`Source: oikos-cash/core @ ${SOURCE_TAG}`);
+  console.log(`        ${SOURCE_URL}`);
+  console.log(`        sha256=${SOURCE_SHA256.slice(0, 12)}\u2026  fetchedAt=${FETCHED_AT}`);
+  console.log("");
+  console.log("Supported networks:");
+  for (const r of rows) {
+    console.log(`  ${r.chainId}	${r.name}	[${r.aliases}]`);
+  }
+}
+function main(argv) {
+  const args = argv.slice(2);
+  if (args.length === 0 || args.includes("-h") || args.includes("--help")) {
+    process.stdout.write(HELP);
+    return 0;
+  }
+  if (args.includes("-l") || args.includes("--list")) {
+    printNetworks();
+    return 0;
+  }
+  const compact = args.includes("-j") || args.includes("--json");
+  const positional = args.filter((a) => !a.startsWith("-"));
+  const [network, contract] = positional;
+  if (!network) {
+    process.stderr.write("Error: missing <network>\n\n");
+    process.stdout.write(HELP);
+    return 1;
+  }
+  try {
+    if (contract) {
+      console.log(getAddress(network, contract));
+    } else {
+      const addrs = getAddresses(network);
+      console.log(
+        compact ? JSON.stringify(addrs) : JSON.stringify(addrs, null, 2)
+      );
+    }
+    return 0;
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    process.stderr.write(`Error: ${msg}
+`);
+    return 1;
+  }
+}
+process.exit(main(process.argv));

package/dist/cli.d.cts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/cli.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/cli.js

@@ -0,0 +1,156 @@
+#!/usr/bin/env node
+
+// data/deployment.json
+var deployment_default = {
+  "56": {
+    Vault: "0x6D77a715d2047a69DFdf922876712c4ef17d1788",
+    Pool: "0x104bab30b2983df47dd504114353B0A73bF663CE",
+    Proxy: "0x614da16Af43A8Ad0b9F419Ab78d14D163DEa6488",
+    ExchangeHelper: "0xe9490B6AA9e3847636CD491f9962Ab2658E589F6",
+    ModelHelper: "0x0b94E3c636C967e1e169faeb268C2ca741E9987A",
+    AdaptiveSupply: "0xd0581Ba58A5970F83ac1F2f23be09202db96303d",
+    RewardsCalculator: "0x88F83ab63ccf9129Cbb681145F879790d29cC4e6",
+    Resolver: "0xa78142B2A829AbA5D737af86a14d2BeEE82dDcF9",
+    Factory: "0x9F5973EC7E5f0781E0fCE71Dd949c997c38508Fc"
+  }
+};
+
+// data/meta.json
+var meta_default = {
+  tag: "v0.1",
+  source: "https://raw.githubusercontent.com/oikos-cash/core/v0.1/deploy_helper/out/deployment.json",
+  fetchedAt: "2026-05-16T19:38:51.457Z",
+  sha256: "5e593341d02a2e9f935d0b234401090c6e858a654fed307ad3ccef83d6fedbb7"
+};
+
+// src/networks.ts
+var NETWORKS = [
+  {
+    chainId: 56,
+    name: "bsc",
+    aliases: ["bsc", "bnb", "binance", "bnbchain", "bsc-mainnet", "bnb-mainnet"]
+  }
+];
+
+// src/index.ts
+var deployment = deployment_default;
+var meta = meta_default;
+var SOURCE_TAG = meta.tag;
+var SOURCE_URL = meta.source;
+var FETCHED_AT = meta.fetchedAt;
+var SOURCE_SHA256 = meta.sha256;
+function resolveChainId(network) {
+  if (typeof network === "number") {
+    if (!Number.isFinite(network) || !Number.isInteger(network)) {
+      throw new Error(`Invalid chain id: ${network}`);
+    }
+    return network;
+  }
+  const s = String(network).toLowerCase().trim();
+  if (s === "") throw new Error("Network identifier is empty");
+  if (/^\d+$/.test(s)) return Number.parseInt(s, 10);
+  const match = NETWORKS.find(
+    (n) => n.name === s || n.aliases.includes(s)
+  );
+  if (!match) {
+    const known = NETWORKS.map((n) => `${n.chainId} (${n.name})`).join(", ");
+    throw new Error(`Unknown network: "${network}". Known: ${known}`);
+  }
+  return match.chainId;
+}
+function getAddresses(network) {
+  const chainId = resolveChainId(network);
+  const addrs = deployment[String(chainId)];
+  if (!addrs) {
+    throw new Error(`No deployment found for chain id ${chainId}`);
+  }
+  return { ...addrs };
+}
+function getAddress(network, contract) {
+  const addrs = getAddresses(network);
+  const addr = addrs[contract];
+  if (!addr) {
+    throw new Error(
+      `Contract "${contract}" not deployed on network ${network}`
+    );
+  }
+  return addr;
+}
+function getSupportedNetworks() {
+  return NETWORKS.filter(
+    (n) => deployment[String(n.chainId)] !== void 0
+  ).map((n) => ({ ...n, aliases: [...n.aliases] }));
+}
+
+// src/cli.ts
+var HELP = `Usage: oikos-addresses <network> [contract]
+
+Print Oikos Protocol contract addresses for a given network.
+
+Arguments:
+  network    Chain id (e.g. 56) or network name (e.g. bsc, bnb, binance)
+  contract   Optional contract name (e.g. Vault). If omitted, prints all.
+
+Examples:
+  oikos-addresses 56
+  oikos-addresses bsc
+  oikos-addresses bsc Vault
+  oikos-addresses --list
+  oikos-addresses --json bsc
+
+Options:
+  -h, --help    Show this help
+  -l, --list    List supported networks
+  -j, --json    Output a single-line JSON (default is pretty-printed JSON)
+`;
+function printNetworks() {
+  const rows = getSupportedNetworks().map((n) => ({
+    chainId: n.chainId,
+    name: n.name,
+    aliases: n.aliases.join(", ")
+  }));
+  console.log(`Source: oikos-cash/core @ ${SOURCE_TAG}`);
+  console.log(`        ${SOURCE_URL}`);
+  console.log(`        sha256=${SOURCE_SHA256.slice(0, 12)}\u2026  fetchedAt=${FETCHED_AT}`);
+  console.log("");
+  console.log("Supported networks:");
+  for (const r of rows) {
+    console.log(`  ${r.chainId}	${r.name}	[${r.aliases}]`);
+  }
+}
+function main(argv) {
+  const args = argv.slice(2);
+  if (args.length === 0 || args.includes("-h") || args.includes("--help")) {
+    process.stdout.write(HELP);
+    return 0;
+  }
+  if (args.includes("-l") || args.includes("--list")) {
+    printNetworks();
+    return 0;
+  }
+  const compact = args.includes("-j") || args.includes("--json");
+  const positional = args.filter((a) => !a.startsWith("-"));
+  const [network, contract] = positional;
+  if (!network) {
+    process.stderr.write("Error: missing <network>\n\n");
+    process.stdout.write(HELP);
+    return 1;
+  }
+  try {
+    if (contract) {
+      console.log(getAddress(network, contract));
+    } else {
+      const addrs = getAddresses(network);
+      console.log(
+        compact ? JSON.stringify(addrs) : JSON.stringify(addrs, null, 2)
+      );
+    }
+    return 0;
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    process.stderr.write(`Error: ${msg}
+`);
+    return 1;
+  }
+}
+process.exit(main(process.argv));

package/dist/index.cjs

@@ -0,0 +1,153 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  FETCHED_AT: () => FETCHED_AT,
+  NETWORKS: () => NETWORKS,
+  SOURCE_SHA256: () => SOURCE_SHA256,
+  SOURCE_TAG: () => SOURCE_TAG,
+  SOURCE_URL: () => SOURCE_URL,
+  deployment: () => deployment,
+  getAddress: () => getAddress,
+  getAddresses: () => getAddresses,
+  getNetworkInfo: () => getNetworkInfo,
+  getSourceMeta: () => getSourceMeta,
+  getSupportedNetworks: () => getSupportedNetworks,
+  isSupported: () => isSupported
+});
+module.exports = __toCommonJS(index_exports);
+
+// data/deployment.json
+var deployment_default = {
+  "56": {
+    Vault: "0x6D77a715d2047a69DFdf922876712c4ef17d1788",
+    Pool: "0x104bab30b2983df47dd504114353B0A73bF663CE",
+    Proxy: "0x614da16Af43A8Ad0b9F419Ab78d14D163DEa6488",
+    ExchangeHelper: "0xe9490B6AA9e3847636CD491f9962Ab2658E589F6",
+    ModelHelper: "0x0b94E3c636C967e1e169faeb268C2ca741E9987A",
+    AdaptiveSupply: "0xd0581Ba58A5970F83ac1F2f23be09202db96303d",
+    RewardsCalculator: "0x88F83ab63ccf9129Cbb681145F879790d29cC4e6",
+    Resolver: "0xa78142B2A829AbA5D737af86a14d2BeEE82dDcF9",
+    Factory: "0x9F5973EC7E5f0781E0fCE71Dd949c997c38508Fc"
+  }
+};
+
+// data/meta.json
+var meta_default = {
+  tag: "v0.1",
+  source: "https://raw.githubusercontent.com/oikos-cash/core/v0.1/deploy_helper/out/deployment.json",
+  fetchedAt: "2026-05-16T19:38:51.457Z",
+  sha256: "5e593341d02a2e9f935d0b234401090c6e858a654fed307ad3ccef83d6fedbb7"
+};
+
+// src/networks.ts
+var NETWORKS = [
+  {
+    chainId: 56,
+    name: "bsc",
+    aliases: ["bsc", "bnb", "binance", "bnbchain", "bsc-mainnet", "bnb-mainnet"]
+  }
+];
+
+// src/index.ts
+var deployment = deployment_default;
+var meta = meta_default;
+var SOURCE_TAG = meta.tag;
+var SOURCE_URL = meta.source;
+var FETCHED_AT = meta.fetchedAt;
+var SOURCE_SHA256 = meta.sha256;
+function getSourceMeta() {
+  return { ...meta };
+}
+function resolveChainId(network) {
+  if (typeof network === "number") {
+    if (!Number.isFinite(network) || !Number.isInteger(network)) {
+      throw new Error(`Invalid chain id: ${network}`);
+    }
+    return network;
+  }
+  const s = String(network).toLowerCase().trim();
+  if (s === "") throw new Error("Network identifier is empty");
+  if (/^\d+$/.test(s)) return Number.parseInt(s, 10);
+  const match = NETWORKS.find(
+    (n) => n.name === s || n.aliases.includes(s)
+  );
+  if (!match) {
+    const known = NETWORKS.map((n) => `${n.chainId} (${n.name})`).join(", ");
+    throw new Error(`Unknown network: "${network}". Known: ${known}`);
+  }
+  return match.chainId;
+}
+function getAddresses(network) {
+  const chainId = resolveChainId(network);
+  const addrs = deployment[String(chainId)];
+  if (!addrs) {
+    throw new Error(`No deployment found for chain id ${chainId}`);
+  }
+  return { ...addrs };
+}
+function getAddress(network, contract) {
+  const addrs = getAddresses(network);
+  const addr = addrs[contract];
+  if (!addr) {
+    throw new Error(
+      `Contract "${contract}" not deployed on network ${network}`
+    );
+  }
+  return addr;
+}
+function getSupportedNetworks() {
+  return NETWORKS.filter(
+    (n) => deployment[String(n.chainId)] !== void 0
+  ).map((n) => ({ ...n, aliases: [...n.aliases] }));
+}
+function isSupported(network) {
+  try {
+    const chainId = resolveChainId(network);
+    return deployment[String(chainId)] !== void 0;
+  } catch {
+    return false;
+  }
+}
+function getNetworkInfo(network) {
+  try {
+    const chainId = resolveChainId(network);
+    const info = NETWORKS.find((n) => n.chainId === chainId);
+    return info ? { ...info, aliases: [...info.aliases] } : void 0;
+  } catch {
+    return void 0;
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  FETCHED_AT,
+  NETWORKS,
+  SOURCE_SHA256,
+  SOURCE_TAG,
+  SOURCE_URL,
+  deployment,
+  getAddress,
+  getAddresses,
+  getNetworkInfo,
+  getSourceMeta,
+  getSupportedNetworks,
+  isSupported
+});

package/dist/index.d.cts

@@ -0,0 +1,31 @@
+type NetworkInfo = {
+    chainId: number;
+    name: string;
+    aliases: readonly string[];
+};
+declare const NETWORKS: readonly NetworkInfo[];
+
+type KnownContractName = "Vault" | "Pool" | "Proxy" | "ExchangeHelper" | "ModelHelper" | "AdaptiveSupply" | "RewardsCalculator" | "Resolver" | "Factory";
+type ContractName = KnownContractName | (string & {});
+type ContractAddresses = Record<string, string>;
+type Deployment = Record<string, ContractAddresses>;
+declare const deployment: Deployment;
+type SourceMeta = {
+    tag: string;
+    source: string;
+    fetchedAt: string;
+    sha256: string;
+};
+declare const SOURCE_TAG: string;
+declare const SOURCE_URL: string;
+declare const FETCHED_AT: string;
+declare const SOURCE_SHA256: string;
+declare function getSourceMeta(): SourceMeta;
+
+declare function getAddresses(network: number | string): ContractAddresses;
+declare function getAddress(network: number | string, contract: ContractName): string;
+declare function getSupportedNetworks(): NetworkInfo[];
+declare function isSupported(network: number | string): boolean;
+declare function getNetworkInfo(network: number | string): NetworkInfo | undefined;
+
+export { type ContractAddresses, type ContractName, type Deployment, FETCHED_AT, type KnownContractName, NETWORKS, type NetworkInfo, SOURCE_SHA256, SOURCE_TAG, SOURCE_URL, type SourceMeta, deployment, getAddress, getAddresses, getNetworkInfo, getSourceMeta, getSupportedNetworks, isSupported };

package/dist/index.d.ts

@@ -0,0 +1,31 @@
+type NetworkInfo = {
+    chainId: number;
+    name: string;
+    aliases: readonly string[];
+};
+declare const NETWORKS: readonly NetworkInfo[];
+
+type KnownContractName = "Vault" | "Pool" | "Proxy" | "ExchangeHelper" | "ModelHelper" | "AdaptiveSupply" | "RewardsCalculator" | "Resolver" | "Factory";
+type ContractName = KnownContractName | (string & {});
+type ContractAddresses = Record<string, string>;
+type Deployment = Record<string, ContractAddresses>;
+declare const deployment: Deployment;
+type SourceMeta = {
+    tag: string;
+    source: string;
+    fetchedAt: string;
+    sha256: string;
+};
+declare const SOURCE_TAG: string;
+declare const SOURCE_URL: string;
+declare const FETCHED_AT: string;
+declare const SOURCE_SHA256: string;
+declare function getSourceMeta(): SourceMeta;
+
+declare function getAddresses(network: number | string): ContractAddresses;
+declare function getAddress(network: number | string, contract: ContractName): string;
+declare function getSupportedNetworks(): NetworkInfo[];
+declare function isSupported(network: number | string): boolean;
+declare function getNetworkInfo(network: number | string): NetworkInfo | undefined;
+
+export { type ContractAddresses, type ContractName, type Deployment, FETCHED_AT, type KnownContractName, NETWORKS, type NetworkInfo, SOURCE_SHA256, SOURCE_TAG, SOURCE_URL, type SourceMeta, deployment, getAddress, getAddresses, getNetworkInfo, getSourceMeta, getSupportedNetworks, isSupported };

package/dist/index.js

@@ -0,0 +1,115 @@
+// data/deployment.json
+var deployment_default = {
+  "56": {
+    Vault: "0x6D77a715d2047a69DFdf922876712c4ef17d1788",
+    Pool: "0x104bab30b2983df47dd504114353B0A73bF663CE",
+    Proxy: "0x614da16Af43A8Ad0b9F419Ab78d14D163DEa6488",
+    ExchangeHelper: "0xe9490B6AA9e3847636CD491f9962Ab2658E589F6",
+    ModelHelper: "0x0b94E3c636C967e1e169faeb268C2ca741E9987A",
+    AdaptiveSupply: "0xd0581Ba58A5970F83ac1F2f23be09202db96303d",
+    RewardsCalculator: "0x88F83ab63ccf9129Cbb681145F879790d29cC4e6",
+    Resolver: "0xa78142B2A829AbA5D737af86a14d2BeEE82dDcF9",
+    Factory: "0x9F5973EC7E5f0781E0fCE71Dd949c997c38508Fc"
+  }
+};
+
+// data/meta.json
+var meta_default = {
+  tag: "v0.1",
+  source: "https://raw.githubusercontent.com/oikos-cash/core/v0.1/deploy_helper/out/deployment.json",
+  fetchedAt: "2026-05-16T19:38:51.457Z",
+  sha256: "5e593341d02a2e9f935d0b234401090c6e858a654fed307ad3ccef83d6fedbb7"
+};
+
+// src/networks.ts
+var NETWORKS = [
+  {
+    chainId: 56,
+    name: "bsc",
+    aliases: ["bsc", "bnb", "binance", "bnbchain", "bsc-mainnet", "bnb-mainnet"]
+  }
+];
+
+// src/index.ts
+var deployment = deployment_default;
+var meta = meta_default;
+var SOURCE_TAG = meta.tag;
+var SOURCE_URL = meta.source;
+var FETCHED_AT = meta.fetchedAt;
+var SOURCE_SHA256 = meta.sha256;
+function getSourceMeta() {
+  return { ...meta };
+}
+function resolveChainId(network) {
+  if (typeof network === "number") {
+    if (!Number.isFinite(network) || !Number.isInteger(network)) {
+      throw new Error(`Invalid chain id: ${network}`);
+    }
+    return network;
+  }
+  const s = String(network).toLowerCase().trim();
+  if (s === "") throw new Error("Network identifier is empty");
+  if (/^\d+$/.test(s)) return Number.parseInt(s, 10);
+  const match = NETWORKS.find(
+    (n) => n.name === s || n.aliases.includes(s)
+  );
+  if (!match) {
+    const known = NETWORKS.map((n) => `${n.chainId} (${n.name})`).join(", ");
+    throw new Error(`Unknown network: "${network}". Known: ${known}`);
+  }
+  return match.chainId;
+}
+function getAddresses(network) {
+  const chainId = resolveChainId(network);
+  const addrs = deployment[String(chainId)];
+  if (!addrs) {
+    throw new Error(`No deployment found for chain id ${chainId}`);
+  }
+  return { ...addrs };
+}
+function getAddress(network, contract) {
+  const addrs = getAddresses(network);
+  const addr = addrs[contract];
+  if (!addr) {
+    throw new Error(
+      `Contract "${contract}" not deployed on network ${network}`
+    );
+  }
+  return addr;
+}
+function getSupportedNetworks() {
+  return NETWORKS.filter(
+    (n) => deployment[String(n.chainId)] !== void 0
+  ).map((n) => ({ ...n, aliases: [...n.aliases] }));
+}
+function isSupported(network) {
+  try {
+    const chainId = resolveChainId(network);
+    return deployment[String(chainId)] !== void 0;
+  } catch {
+    return false;
+  }
+}
+function getNetworkInfo(network) {
+  try {
+    const chainId = resolveChainId(network);
+    const info = NETWORKS.find((n) => n.chainId === chainId);
+    return info ? { ...info, aliases: [...info.aliases] } : void 0;
+  } catch {
+    return void 0;
+  }
+}
+export {
+  FETCHED_AT,
+  NETWORKS,
+  SOURCE_SHA256,
+  SOURCE_TAG,
+  SOURCE_URL,
+  deployment,
+  getAddress,
+  getAddresses,
+  getNetworkInfo,
+  getSourceMeta,
+  getSupportedNetworks,
+  isSupported
+};

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@oikos/core-addresses",
+  "version": "0.1.0",
+  "description": "Oikos Protocol contract addresses, addressable by network ID or name. Bundled from a pinned oikos-cash/core release tag.",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "bin": {
+    "oikos-addresses": "./dist/cli.cjs"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "fetch-deployment": "node scripts/fetch-deployment.mjs",
+    "prebuild": "npm run fetch-deployment",
+    "build": "tsup",
+    "pretypecheck": "npm run fetch-deployment",
+    "typecheck": "tsc --noEmit",
+    "pretest": "npm run build",
+    "test": "node --test test/*.test.mjs",
+    "prepare": "npm run build",
+    "prepublishOnly": "npm run build"
+  },
+  "oikosCoreTag": "v0.1",
+  "keywords": [
+    "oikos",
+    "oikos-protocol",
+    "addresses",
+    "contracts",
+    "bnb",
+    "bsc",
+    "binance-smart-chain",
+    "defi",
+    "ethereum"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/oikos-cash/core-addresses.git"
+  },
+  "homepage": "https://github.com/oikos-cash/core-addresses#readme",
+  "bugs": {
+    "url": "https://github.com/oikos-cash/core-addresses/issues"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "devDependencies": {
+    "@types/node": "^20.19.41",
+    "tsup": "^8.3.0",
+    "typescript": "^5.6.0"
+  }
+}