@aromedia/contracts-sdk 0.2.0 → 1.0.0

package/dist/{onboarding-DxL_LpM3.d.ts → onboarding-BD_g7Len.d.ts}

@@ -2,7 +2,15 @@ import { PublicClient, WalletClient, GetContractReturnType, Chain, Transport, Ac
 import { AroChainId } from './generated/addresses.js';
 import { AroMediaAccessManager_ABI, AroMediaAssetsRegistry_ABI, ForcedTransferManager_ABI, AroMediaIncMultiSig_ABI, AroNomination_ABI, AroMediaRWA_ABI, AroSBT_ABI } from './generated/abis.js';
 
-/** Mirrors AroSBT.Tier. */
+/**
+ * Conventional default tier labels for AroSBT membership.
+ *
+ * On-chain, the SBT's `tier` is now an opaque `uint256` whose semantics
+ * are defined off-chain by the admin backend (no on-chain logic branches
+ * on it). These enum values are the conventional defaults the dapp
+ * displays when no off-chain override is available; new tier ids can be
+ * introduced server-side without a contract upgrade or SDK release.
+ */
 declare enum AroTier {
     STANDARD = 0,
     VERIFIED = 1,
@@ -10,13 +18,19 @@ declare enum AroTier {
     FOUNDING = 3
 }
 declare const AroTierLabels: Record<AroTier, string>;
-/** Mirrors AroNomination.NominationStatus. */
+/**
+ * @deprecated Mirrors AroNomination.NominationStatus. The on-chain
+ * nomination flow is being retired in favor of an admin-portal backend
+ * flow (see the AroNomination_ABI deprecation). New consumers should
+ * read status from the admin portal API instead.
+ */
 declare enum NominationStatus {
     NONE = 0,
     PENDING = 1,
     APPROVED = 2,
     CLEARED = 3
 }
+/** @deprecated See NominationStatus. */
 declare const NominationStatusLabels: Record<NominationStatus, string>;
 /** Mirrors ForcedTransferManager.ForcedTransferStatus. */
 declare enum ForcedTransferStatus {
@@ -187,11 +201,22 @@ declare function createAroSdk(opts: CreateAroSdkOpts): AroSdk;
 declare function addressesFor(chainId: AroChainId): Record<keyof AroAddressOverrides, `0x${string}`>;
 
 /**
- * Onboarding workflow helpers. These wrap multi-call sequences from the
- * ARO KYC/AML/CFT Policy §6 so the dapp does not have to re-implement the
- * choreography in three different places.
+ * Onboarding workflow helpers.
+ *
+ * STATUS: The on-chain nomination + admin-mint helpers below are
+ * @deprecated and slated for removal in a future major release. The
+ * nomination flow has moved to the admin backend (see the admin portal's
+ * /access-control + onboarding API), and SBT minting is now
+ * candidate-triggered against an EIP-712 voucher
+ * (`AroSBT.mintWithApproval`; see `../utils/mintApproval.ts` and
+ * `../hooks/useAroSBT.ts::useMintWithApproval`). The on-chain
+ * `AroNomination` contract is retained on Sepolia for compatibility but
+ * is no longer deployed to new networks.
+ *
+ * Status-read helpers (`checkMembershipStatus`, `describeOnboardingState`)
+ * remain useful regardless of the underlying flow and are NOT deprecated.
  *
- * Mental model (per Policy §6.3):
+ * Original mental model (kept for reference; pre-migration):
  *
  *   1. Existing member calls `nominateCandidate(candidate)`.
  *      The nominator's vouch counts as the first vouch automatically.
@@ -216,7 +241,12 @@ declare function addressesFor(chainId: AroChainId): Record<keyof AroAddressOverr
  */
 interface MembershipStatus {
     hasSBT: boolean;
-    tier?: AroTier;
+    /**
+     * Opaque tier id (uint256) as returned by AroSBT.getMemberData. Compare
+     * with `tierLabel`, `tierAtLeast`, or the AroTier enum values for the
+     * conventional defaults; semantics live off-chain in the admin backend.
+     */
+    tier?: bigint;
     tokenId?: bigint;
     memberId?: bigint;
     issuanceDate?: bigint;
@@ -246,9 +276,16 @@ interface NominationSnapshot {
 /**
  * Snapshot of the candidate's progress through the vouch flow. The dapp
  * shows this as "you need N more vouches" in the onboarding UI.
+ *
+ * @deprecated On-chain nomination is retired. Read this status from the
+ * admin portal's onboarding API instead. Removal planned in a future
+ * major release.
  */
 declare function getNominationSnapshot(sdk: AroSdk, candidate: `0x${string}`): Promise<NominationSnapshot>;
 /**
+ * @deprecated On-chain nomination is retired. Use the admin portal's
+ * onboarding API instead. Removal planned in a future major release.
+ *
  * Send `nominate(candidate)` from the connected wallet. The contract
  * gates this behind "caller must already be an SBT holder"; we surface
  * the right user-facing message via `AroContractError`.
@@ -256,10 +293,17 @@ declare function getNominationSnapshot(sdk: AroSdk, candidate: `0x${string}`): P
 declare function nominateCandidate(sdk: AroSdk, candidate: `0x${string}`, opts?: {
     account?: Account | `0x${string}`;
 }): Promise<Hex>;
+/**
+ * @deprecated On-chain vouching is retired. Use the admin portal's
+ * onboarding API instead. Removal planned in a future major release.
+ */
 declare function vouchForCandidate(sdk: AroSdk, candidate: `0x${string}`, opts?: {
     account?: Account | `0x${string}`;
 }): Promise<Hex>;
 /**
+ * @deprecated On-chain nomination is retired. The admin portal handles
+ * rejections in its backend. Removal planned in a future major release.
+ *
  * Admin path: clear (reject) a nomination. Restricted to authorized roles
  * via AccessManager; will revert with AccessManagedUnauthorized if the
  * caller lacks the role.
@@ -273,11 +317,22 @@ interface MintSBTOpts {
     kycHash: `0x${string}`;
     /** Off-chain profile metadata URI (ipfs://... or https://...). */
     metadataURI: string;
-    /** Initial tier (defaults to STANDARD per Policy §6.1). */
-    tier?: AroTier;
+    /**
+     * Initial tier id (opaque uint256; defaults to 0 / "Standard"). Accepts
+     * AroTier enum values for the conventional defaults, or any bigint id
+     * defined off-chain by the admin backend.
+     */
+    tier?: bigint | AroTier;
     account?: Account | `0x${string}`;
 }
 /**
+ * @deprecated SBT minting is now candidate-triggered against an EIP-712
+ * voucher (`AroSBT.mintWithApproval`). The admin backend issues vouchers
+ * via `signMintApproval` in `../utils/mintApproval`, and the candidate
+ * submits via the `useMintWithApproval` hook in `../hooks/useAroSBT`.
+ * The direct admin mint below remains gated by ROLE_MINTER but is the
+ * legacy path; removal planned in a future major release.
+ *
  * Admin-only: mint the SBT for an approved candidate. The contract gates
  * this behind ROLE_MINTER via AccessManager (per AroMediaAccessManager).
  *

package/dist/{onboarding-BHpAJaNW.d.cts → onboarding-DDKwXy8O.d.cts}

@@ -2,7 +2,15 @@ import { PublicClient, WalletClient, GetContractReturnType, Chain, Transport, Ac
 import { AroChainId } from './generated/addresses.cjs';
 import { AroMediaAccessManager_ABI, AroMediaAssetsRegistry_ABI, ForcedTransferManager_ABI, AroMediaIncMultiSig_ABI, AroNomination_ABI, AroMediaRWA_ABI, AroSBT_ABI } from './generated/abis.cjs';
 
-/** Mirrors AroSBT.Tier. */
+/**
+ * Conventional default tier labels for AroSBT membership.
+ *
+ * On-chain, the SBT's `tier` is now an opaque `uint256` whose semantics
+ * are defined off-chain by the admin backend (no on-chain logic branches
+ * on it). These enum values are the conventional defaults the dapp
+ * displays when no off-chain override is available; new tier ids can be
+ * introduced server-side without a contract upgrade or SDK release.
+ */
 declare enum AroTier {
     STANDARD = 0,
     VERIFIED = 1,
@@ -10,13 +18,19 @@ declare enum AroTier {
     FOUNDING = 3
 }
 declare const AroTierLabels: Record<AroTier, string>;
-/** Mirrors AroNomination.NominationStatus. */
+/**
+ * @deprecated Mirrors AroNomination.NominationStatus. The on-chain
+ * nomination flow is being retired in favor of an admin-portal backend
+ * flow (see the AroNomination_ABI deprecation). New consumers should
+ * read status from the admin portal API instead.
+ */
 declare enum NominationStatus {
     NONE = 0,
     PENDING = 1,
     APPROVED = 2,
     CLEARED = 3
 }
+/** @deprecated See NominationStatus. */
 declare const NominationStatusLabels: Record<NominationStatus, string>;
 /** Mirrors ForcedTransferManager.ForcedTransferStatus. */
 declare enum ForcedTransferStatus {
@@ -187,11 +201,22 @@ declare function createAroSdk(opts: CreateAroSdkOpts): AroSdk;
 declare function addressesFor(chainId: AroChainId): Record<keyof AroAddressOverrides, `0x${string}`>;
 
 /**
- * Onboarding workflow helpers. These wrap multi-call sequences from the
- * ARO KYC/AML/CFT Policy §6 so the dapp does not have to re-implement the
- * choreography in three different places.
+ * Onboarding workflow helpers.
+ *
+ * STATUS: The on-chain nomination + admin-mint helpers below are
+ * @deprecated and slated for removal in a future major release. The
+ * nomination flow has moved to the admin backend (see the admin portal's
+ * /access-control + onboarding API), and SBT minting is now
+ * candidate-triggered against an EIP-712 voucher
+ * (`AroSBT.mintWithApproval`; see `../utils/mintApproval.ts` and
+ * `../hooks/useAroSBT.ts::useMintWithApproval`). The on-chain
+ * `AroNomination` contract is retained on Sepolia for compatibility but
+ * is no longer deployed to new networks.
+ *
+ * Status-read helpers (`checkMembershipStatus`, `describeOnboardingState`)
+ * remain useful regardless of the underlying flow and are NOT deprecated.
  *
- * Mental model (per Policy §6.3):
+ * Original mental model (kept for reference; pre-migration):
  *
  *   1. Existing member calls `nominateCandidate(candidate)`.
  *      The nominator's vouch counts as the first vouch automatically.
@@ -216,7 +241,12 @@ declare function addressesFor(chainId: AroChainId): Record<keyof AroAddressOverr
  */
 interface MembershipStatus {
     hasSBT: boolean;
-    tier?: AroTier;
+    /**
+     * Opaque tier id (uint256) as returned by AroSBT.getMemberData. Compare
+     * with `tierLabel`, `tierAtLeast`, or the AroTier enum values for the
+     * conventional defaults; semantics live off-chain in the admin backend.
+     */
+    tier?: bigint;
     tokenId?: bigint;
     memberId?: bigint;
     issuanceDate?: bigint;
@@ -246,9 +276,16 @@ interface NominationSnapshot {
 /**
  * Snapshot of the candidate's progress through the vouch flow. The dapp
  * shows this as "you need N more vouches" in the onboarding UI.
+ *
+ * @deprecated On-chain nomination is retired. Read this status from the
+ * admin portal's onboarding API instead. Removal planned in a future
+ * major release.
  */
 declare function getNominationSnapshot(sdk: AroSdk, candidate: `0x${string}`): Promise<NominationSnapshot>;
 /**
+ * @deprecated On-chain nomination is retired. Use the admin portal's
+ * onboarding API instead. Removal planned in a future major release.
+ *
  * Send `nominate(candidate)` from the connected wallet. The contract
  * gates this behind "caller must already be an SBT holder"; we surface
  * the right user-facing message via `AroContractError`.
@@ -256,10 +293,17 @@ declare function getNominationSnapshot(sdk: AroSdk, candidate: `0x${string}`): P
 declare function nominateCandidate(sdk: AroSdk, candidate: `0x${string}`, opts?: {
     account?: Account | `0x${string}`;
 }): Promise<Hex>;
+/**
+ * @deprecated On-chain vouching is retired. Use the admin portal's
+ * onboarding API instead. Removal planned in a future major release.
+ */
 declare function vouchForCandidate(sdk: AroSdk, candidate: `0x${string}`, opts?: {
     account?: Account | `0x${string}`;
 }): Promise<Hex>;
 /**
+ * @deprecated On-chain nomination is retired. The admin portal handles
+ * rejections in its backend. Removal planned in a future major release.
+ *
  * Admin path: clear (reject) a nomination. Restricted to authorized roles
  * via AccessManager; will revert with AccessManagedUnauthorized if the
  * caller lacks the role.
@@ -273,11 +317,22 @@ interface MintSBTOpts {
     kycHash: `0x${string}`;
     /** Off-chain profile metadata URI (ipfs://... or https://...). */
     metadataURI: string;
-    /** Initial tier (defaults to STANDARD per Policy §6.1). */
-    tier?: AroTier;
+    /**
+     * Initial tier id (opaque uint256; defaults to 0 / "Standard"). Accepts
+     * AroTier enum values for the conventional defaults, or any bigint id
+     * defined off-chain by the admin backend.
+     */
+    tier?: bigint | AroTier;
     account?: Account | `0x${string}`;
 }
 /**
+ * @deprecated SBT minting is now candidate-triggered against an EIP-712
+ * voucher (`AroSBT.mintWithApproval`). The admin backend issues vouchers
+ * via `signMintApproval` in `../utils/mintApproval`, and the candidate
+ * submits via the `useMintWithApproval` hook in `../hooks/useAroSBT`.
+ * The direct admin mint below remains gated by ROLE_MINTER but is the
+ * legacy path; removal planned in a future major release.
+ *
  * Admin-only: mint the SBT for an approved candidate. The contract gates
  * this behind ROLE_MINTER via AccessManager (per AroMediaAccessManager).
  *

package/dist/workflows/index.cjs

@@ -94,6 +94,82 @@ var AroSBT_ABI = [
     "name": "AlreadyHasSBT",
     "type": "error"
   },
+  {
+    "inputs": [
+      {
+        "internalType": "bytes32",
+        "name": "approvalDigest",
+        "type": "bytes32"
+      }
+    ],
+    "name": "ApprovalAlreadyUsed",
+    "type": "error"
+  },
+  {
+    "inputs": [
+      {
+        "internalType": "address",
+        "name": "expected",
+        "type": "address"
+      },
+      {
+        "internalType": "address",
+        "name": "caller",
+        "type": "address"
+      }
+    ],
+    "name": "ApprovalCandidateMismatch",
+    "type": "error"
+  },
+  {
+    "inputs": [
+      {
+        "internalType": "uint64",
+        "name": "deadline",
+        "type": "uint64"
+      }
+    ],
+    "name": "ApprovalExpired",
+    "type": "error"
+  },
+  {
+    "inputs": [
+      {
+        "internalType": "address",
+        "name": "signer",
+        "type": "address"
+      }
+    ],
+    "name": "ApprovalSignerNotApprover",
+    "type": "error"
+  },
+  {
+    "inputs": [],
+    "name": "ECDSAInvalidSignature",
+    "type": "error"
+  },
+  {
+    "inputs": [
+      {
+        "internalType": "uint256",
+        "name": "length",
+        "type": "uint256"
+      }
+    ],
+    "name": "ECDSAInvalidSignatureLength",
+    "type": "error"
+  },
+  {
+    "inputs": [
+      {
+        "internalType": "bytes32",
+        "name": "s",
+        "type": "bytes32"
+      }
+    ],
+    "name": "ECDSAInvalidSignatureS",
+    "type": "error"
+  },
   {
     "inputs": [],
     "name": "ERC721EnumerableForbiddenBatchMint",
@@ -228,6 +304,11 @@ var AroSBT_ABI = [
     "name": "ExpectedPause",
     "type": "error"
   },
+  {
+    "inputs": [],
+    "name": "InvalidShortString",
+    "type": "error"
+  },
   {
     "inputs": [
       {
@@ -244,6 +325,17 @@ var AroSBT_ABI = [
     "name": "SoulboundTransferBlocked",
     "type": "error"
   },
+  {
+    "inputs": [
+      {
+        "internalType": "string",
+        "name": "str",
+        "type": "string"
+      }
+    ],
+    "name": "StringTooLong",
+    "type": "error"
+  },
   {
     "anonymous": false,
     "inputs": [
@@ -326,6 +418,12 @@ var AroSBT_ABI = [
     "name": "BatchMetadataUpdate",
     "type": "event"
   },
+  {
+    "anonymous": false,
+    "inputs": [],
+    "name": "EIP712DomainChanged",
+    "type": "event"
+  },
   {
     "anonymous": false,
     "inputs": [
@@ -362,9 +460,9 @@ var AroSBT_ABI = [
       },
       {
         "indexed": false,
-        "internalType": "enum AroSBT.Tier",
+        "internalType": "uint256",
         "name": "tier",
-        "type": "uint8"
+        "type": "uint256"
       },
       {
         "indexed": false,
@@ -414,6 +512,37 @@ var AroSBT_ABI = [
     "name": "MetadataUpdate",
     "type": "event"
   },
+  {
+    "anonymous": false,
+    "inputs": [
+      {
+        "indexed": true,
+        "internalType": "address",
+        "name": "candidate",
+        "type": "address"
+      },
+      {
+        "indexed": true,
+        "internalType": "bytes32",
+        "name": "approvalDigest",
+        "type": "bytes32"
+      },
+      {
+        "indexed": true,
+        "internalType": "address",
+        "name": "approver",
+        "type": "address"
+      },
+      {
+        "indexed": false,
+        "internalType": "bytes32",
+        "name": "nominationId",
+        "type": "bytes32"
+      }
+    ],
+    "name": "MintApprovalConsumed",
+    "type": "event"
+  },
   {
     "anonymous": false,
     "inputs": [
@@ -444,15 +573,15 @@ var AroSBT_ABI = [
       },
       {
         "indexed": false,
-        "internalType": "enum AroSBT.Tier",
+        "internalType": "uint256",
         "name": "oldTier",
-        "type": "uint8"
+        "type": "uint256"
       },
       {
         "indexed": false,
-        "internalType": "enum AroSBT.Tier",
+        "internalType": "uint256",
         "name": "newTier",
-        "type": "uint8"
+        "type": "uint256"
       }
     ],
     "name": "TierUpdated",
@@ -509,6 +638,19 @@ var AroSBT_ABI = [
     "name": "Unpaused",
     "type": "event"
   },
+  {
+    "inputs": [],
+    "name": "APPROVER_ROLE",
+    "outputs": [
+      {
+        "internalType": "uint64",
+        "name": "",
+        "type": "uint64"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
   {
     "inputs": [
       {
@@ -559,6 +701,49 @@ var AroSBT_ABI = [
     "stateMutability": "view",
     "type": "function"
   },
+  {
+    "inputs": [],
+    "name": "eip712Domain",
+    "outputs": [
+      {
+        "internalType": "bytes1",
+        "name": "fields",
+        "type": "bytes1"
+      },
+      {
+        "internalType": "string",
+        "name": "name",
+        "type": "string"
+      },
+      {
+        "internalType": "string",
+        "name": "version",
+        "type": "string"
+      },
+      {
+        "internalType": "uint256",
+        "name": "chainId",
+        "type": "uint256"
+      },
+      {
+        "internalType": "address",
+        "name": "verifyingContract",
+        "type": "address"
+      },
+      {
+        "internalType": "bytes32",
+        "name": "salt",
+        "type": "bytes32"
+      },
+      {
+        "internalType": "uint256[]",
+        "name": "extensions",
+        "type": "uint256[]"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
   {
     "inputs": [
       {
@@ -601,9 +786,9 @@ var AroSBT_ABI = [
             "type": "uint256"
           },
           {
-            "internalType": "enum AroSBT.Tier",
+            "internalType": "uint256",
             "name": "tier",
-            "type": "uint8"
+            "type": "uint256"
           },
           {
             "internalType": "bytes32",
@@ -642,9 +827,9 @@ var AroSBT_ABI = [
             "type": "uint256"
           },
           {
-            "internalType": "enum AroSBT.Tier",
+            "internalType": "uint256",
             "name": "tier",
-            "type": "uint8"
+            "type": "uint256"
           },
           {
             "internalType": "bytes32",
@@ -751,6 +936,11 @@ var AroSBT_ABI = [
         "internalType": "string",
         "name": "metadataURI",
         "type": "string"
+      },
+      {
+        "internalType": "uint256",
+        "name": "tier",
+        "type": "uint256"
       }
     ],
     "name": "mint",
@@ -780,14 +970,70 @@ var AroSBT_ABI = [
         "internalType": "string",
         "name": "metadataURI",
         "type": "string"
+      }
+    ],
+    "name": "mint",
+    "outputs": [
+      {
+        "internalType": "uint256",
+        "name": "",
+        "type": "uint256"
+      }
+    ],
+    "stateMutability": "nonpayable",
+    "type": "function"
+  },
+  {
+    "inputs": [
+      {
+        "components": [
+          {
+            "internalType": "address",
+            "name": "candidate",
+            "type": "address"
+          },
+          {
+            "internalType": "uint256",
+            "name": "tier",
+            "type": "uint256"
+          },
+          {
+            "internalType": "bytes32",
+            "name": "kycHash",
+            "type": "bytes32"
+          },
+          {
+            "internalType": "bytes32",
+            "name": "nominationId",
+            "type": "bytes32"
+          },
+          {
+            "internalType": "string",
+            "name": "metadataURI",
+            "type": "string"
+          },
+          {
+            "internalType": "uint64",
+            "name": "deadline",
+            "type": "uint64"
+          },
+          {
+            "internalType": "bytes32",
+            "name": "nonce",
+            "type": "bytes32"
+          }
+        ],
+        "internalType": "struct AroSBT.MintApproval",
+        "name": "approval",
+        "type": "tuple"
       },
       {
-        "internalType": "enum AroSBT.Tier",
-        "name": "tier",
-        "type": "uint8"
+        "internalType": "bytes",
+        "name": "signature",
+        "type": "bytes"
       }
     ],
-    "name": "mint",
+    "name": "mintWithApproval",
     "outputs": [
       {
         "internalType": "uint256",
@@ -953,9 +1199,9 @@ var AroSBT_ABI = [
         "type": "uint256"
       },
       {
-        "internalType": "enum AroSBT.Tier",
+        "internalType": "uint256",
         "name": "newTier",
-        "type": "uint8"
+        "type": "uint256"
       }
     ],
     "name": "setTier",
@@ -1149,6 +1395,25 @@ var AroSBT_ABI = [
     "outputs": [],
     "stateMutability": "nonpayable",
     "type": "function"
+  },
+  {
+    "inputs": [
+      {
+        "internalType": "bytes32",
+        "name": "",
+        "type": "bytes32"
+      }
+    ],
+    "name": "usedApprovals",
+    "outputs": [
+      {
+        "internalType": "bool",
+        "name": "",
+        "type": "bool"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
   }
 ];
 var AroNomination_ABI = [
@@ -1890,7 +2155,7 @@ async function mintSBTForApproved(sdk, opts) {
     throw new Error("mintSBTForApproved requires a walletClient on the SDK");
   }
   const wallet = sdk.walletClient;
-  const tier = opts.tier ?? 0 /* STANDARD */;
+  const tier = opts.tier === void 0 ? 0n : typeof opts.tier === "bigint" ? opts.tier : BigInt(opts.tier);
   try {
     return await wallet.writeContract({
       account: pickAccount(wallet, opts.account),