SDK — @nullis/sdk

npm install @nullis/sdk @nullis/core

import { Nullis } from "@nullis/sdk";

const nullis = new Nullis({ contractId, secretKey });
const receipt = await nullis.verifyAndExecute({ policyId, publicInputs, proof, action });
// receipt.result === "VERIFIED", receipt.executed === true  → the asset moved

new Nullis({
  contractId: string,          // deployed Nullis contract id
  rpcUrl?: string,             // defaults to Soroban testnet
  networkPassphrase?: string,  // defaults to Testnet
  secretKey?: string,          // S… — required only for verifyAndExecute
});

import { policyHash } from "@nullis/core";
import { buildRequest, addrToField } from "@nullis/sdk";

const req = buildRequest({
  policyId, policyHash: pHash, policyVersion: 1, approvedRoot,
  appDomainHash, policyExpiry, networkId, nullisContract,
  credentialSecret,
  action: { actionType, recipient, amount, asset, consumingContract, intentNonce },
});
// req.publicInputs.{contextHash, actionId, nullifier} are derived for you

interface OnChainReceipt {
  result: string;          // "VERIFIED" | "REPLAY" | reason
  executed: boolean;       // did the asset move?
  policyId: bigint;
  version: number;
  actionType: number;
  amount: bigint;
  asset: string;
  nullifier: bigint;
  identityDisclosed: boolean;   // always false
  crossAppIdentifier: boolean;  // always false
  ledger: number;
  txHash?: string;              // for explorer linking
}