@aromedia/contracts-sdk 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Aro Media Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+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, 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

@@ -0,0 +1,121 @@
+# @aromedia/contracts-sdk
+
+TypeScript SDK for the [Aro Media](https://aro.media) on-chain ecosystem. Wraps every contract in [`aromedia-blockchain-contracts`](https://github.com/aromediainc/aromedia-blockchain-contracts) (SBT identity, nomination workflow, RWA security token, assets registry, access manager, multisig, forced-transfer manager) behind a single typed API.
+
+Designed for both server-side use (deploy helpers, indexers, jobs) and the Next.js dapp. React-specific code is gated behind a sub-path so consumers that don't need wagmi don't pull React in.
+
+```bash
+npm install @aromedia/contracts-sdk
+```
+
+## Quick start
+
+### Core (server, scripts, anything non-React)
+
+```ts
+import { createAroSdk, sepolia } from "@aromedia/contracts-sdk";
+
+const sdk = createAroSdk({ chain: sepolia });
+const isMember = await sdk.sbt.read.hasSBT([userAddress]);
+```
+
+### React / wagmi
+
+```tsx
+import { useMembership } from "@aromedia/contracts-sdk/hooks";
+
+const { data, isLoading } = useMembership(account);
+// data.step ∈ "needs-wallet" | "needs-nomination" | "needs-vouches"
+//           | "needs-kyc" | "needs-admin-mint" | "member"
+```
+
+### Onboarding (aligned with the ARO KYC/AML/CFT Policy)
+
+```ts
+import {
+  describeOnboardingState,
+  nominateCandidate,
+  vouchForCandidate,
+  mintSBTForApproved,
+  hashKycResult,
+  AroTier,
+} from "@aromedia/contracts-sdk";
+
+await nominateCandidate(sdk, candidateAddress);
+await vouchForCandidate(sdk, candidateAddress);
+
+const kycHash = hashKycResult({
+  provider: "didit",
+  sessionId,
+  status: "verified",
+  verifiedAt,
+  walletAddress: candidateAddress,
+});
+
+await mintSBTForApproved(sdk, {
+  to: candidateAddress,
+  kycHash,
+  metadataURI: "ipfs://...",
+  tier: AroTier.STANDARD,
+});
+```
+
+## Entry points
+
+| Import path                           | What it gives you                                 |
+| :------------------------------------ | :------------------------------------------------ |
+| `@aromedia/contracts-sdk`           | Clients, workflows, utils, types — no React      |
+| `@aromedia/contracts-sdk/hooks`     | wagmi React hooks (peer dep on wagmi + react)     |
+| `@aromedia/contracts-sdk/abis`      | Raw ABIs only (tree-shake friendly, zero runtime) |
+| `@aromedia/contracts-sdk/addresses` | Per-chain deployed-address registry               |
+| `@aromedia/contracts-sdk/chains`    | Chain configs the SDK supports                    |
+| `@aromedia/contracts-sdk/workflows` | High-level domain helpers                         |
+
+## Development
+
+### Repository layout
+
+```
+aromediainc/
+├── sdks/contracts-sdk/                ← this repo
+└── aromedia-blockchain-contracts/     ← sibling; source of ABIs + deployment addresses
+```
+
+The SDK ships generated ABIs and addresses under `src/generated/`, so installing the published package does NOT require Hardhat. The generator is only needed when contracts change.
+
+### Regenerating from the contracts repo
+
+```bash
+# in aromedia-blockchain-contracts/
+npm run compile           # rebuild Hardhat artifacts
+
+# in this repo
+npm run generate          # reads sibling contracts repo, writes src/generated/
+npm run build             # bundle dist/
+npm run typecheck
+```
+
+You can override the contracts repo location with `CONTRACTS_REPO_PATH`:
+
+```bash
+CONTRACTS_REPO_PATH=/path/to/aromedia-blockchain-contracts npm run generate
+```
+
+### Releasing
+
+This repo uses [Changesets](https://github.com/changesets/changesets) for semver-driven releases.
+
+1. After your change, run `npm run changeset` and describe the change (`patch` / `minor` / `major`).
+2. Commit the resulting file under `.changeset/` alongside your code.
+3. When the PR merges to `main`, the `release` workflow opens (or updates) a "Version Packages" PR that consumes pending changesets and bumps the version + CHANGELOG.
+4. Merging the Version Packages PR triggers the publish step, which builds and runs `changeset publish` against npm.
+
+### CI
+
+- `ci.yml` — typecheck + build on every PR.
+- `release.yml` — Version PR + npm publish on `main`.
+- `sync-abis.yml` — nightly job that clones the contracts repo, regenerates ABIs/addresses, and opens a PR if anything changed.
+
+## License
+
+[MIT](./LICENSE) © Aro Media Inc.

package/dist/chains.cjs

@@ -0,0 +1,67 @@
+"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/chains.ts
+var chains_exports = {};
+__export(chains_exports, {
+  DEFAULT_CHAIN: () => DEFAULT_CHAIN,
+  aroChains: () => aroChains,
+  base: () => import_chains.base,
+  baseSepolia: () => import_chains.baseSepolia,
+  chainById: () => chainById,
+  getChain: () => getChain,
+  hardhat: () => import_chains.hardhat,
+  mainnet: () => import_chains.mainnet,
+  sepolia: () => import_chains.sepolia
+});
+module.exports = __toCommonJS(chains_exports);
+var import_chains = require("viem/chains");
+var aroChains = {
+  mainnet: import_chains.mainnet,
+  sepolia: import_chains.sepolia,
+  base: import_chains.base,
+  baseSepolia: import_chains.baseSepolia,
+  hardhat: import_chains.hardhat
+};
+var chainById = {
+  1: import_chains.mainnet,
+  11155111: import_chains.sepolia,
+  8453: import_chains.base,
+  84532: import_chains.baseSepolia,
+  31337: import_chains.hardhat
+};
+var DEFAULT_CHAIN = import_chains.sepolia;
+function getChain(chainId) {
+  const chain = chainById[chainId];
+  if (!chain) throw new Error(`Unsupported chainId ${chainId}`);
+  return chain;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DEFAULT_CHAIN,
+  aroChains,
+  base,
+  baseSepolia,
+  chainById,
+  getChain,
+  hardhat,
+  mainnet,
+  sepolia
+});
+//# sourceMappingURL=chains.cjs.map

package/dist/chains.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/chains.ts"],"sourcesContent":["import { base, baseSepolia, hardhat, mainnet, sepolia } from \"viem/chains\";\nimport type { Chain } from \"viem\";\n\nimport type { AroChainId } from \"./generated/addresses.js\";\n\n/**\n * Chains the SDK has first-class support for. Re-exported from viem to keep\n * the consumer's chain instance identical to ours — this matters because\n * wagmi keys its provider registry by chain object identity.\n */\nexport const aroChains = {\n  mainnet,\n  sepolia,\n  base,\n  baseSepolia,\n  hardhat,\n} as const;\n\nexport type AroChainLabel = keyof typeof aroChains;\n\n/** Map from chainId → viem chain. */\nexport const chainById: Record<AroChainId, Chain> = {\n  1: mainnet,\n  11155111: sepolia,\n  8453: base,\n  84532: baseSepolia,\n  31337: hardhat,\n};\n\n/**\n * The chain we treat as the production deployment target. Sepolia today;\n * flip to `base` or `mainnet` once the contracts are deployed there.\n */\nexport const DEFAULT_CHAIN: Chain = sepolia;\n\nexport function getChain(chainId: AroChainId): Chain {\n  const chain = chainById[chainId];\n  if (!chain) throw new Error(`Unsupported chainId ${chainId}`);\n  return chain;\n}\n\nexport { mainnet, sepolia, base, baseSepolia, hardhat };\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,oBAA6D;AAUtD,IAAM,YAAY;AAAA,EACvB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAKO,IAAM,YAAuC;AAAA,EAClD,GAAG;AAAA,EACH,UAAU;AAAA,EACV,MAAM;AAAA,EACN,OAAO;AAAA,EACP,OAAO;AACT;AAMO,IAAM,gBAAuB;AAE7B,SAAS,SAAS,SAA4B;AACnD,QAAM,QAAQ,UAAU,OAAO;AAC/B,MAAI,CAAC,MAAO,OAAM,IAAI,MAAM,uBAAuB,OAAO,EAAE;AAC5D,SAAO;AACT;","names":[]}