Build with ALMA

npm install @adasouls/alma-core

import { createIdentity, createDelegation, createRelationship, recordEvidence } from "@adasouls/alma-core";

const org = createIdentity({ subjectType: "organization", displayName: "Acme Labs" });
const agent = createIdentity({ subjectType: "agent", displayName: "Treasury Agent", principal: org.id, controllers: [{ type: "wallet", value: "0x8F12…21C" }] });
const delegation = createDelegation({ issuer: org.id, subject: agent.id, scope: { capabilities: ["pay"], constraints: { maxTransaction: { USDC: "1000" } } }, expiresAt: "2027-01-01T00:00:00Z" });
createRelationship({ from: org.id, to: agent.id, type: "delegates", sourceRef: delegation.id });
recordEvidence({ subject: agent.id, role: "agent", source: { type: "economic-action", reference: "eco_123" }, outcome: "success" });
console.log(org.id); // alma:main:organization:acme-labs
console.log(agent.id); // alma:main:agent:treasury-agent

import { LocalSigner, buildReceiptStatement, receiptDigest, toBaseUnits, signReceiptMint, signReceiptAttestation, createIssuerKeyset, verifyReceipt } from "@adasouls/alma-core";

const issuer = await LocalSigner.generate(); // a local test key; a production key belongs in a KMS
const statement = buildReceiptStatement({
  issuer: "demo-issuer",
  env: "testnet",
  action: "eco_123",
  payer: "alma:main:agent:buyer",
  payee: "alma:main:agent:vendor",
  capability: "pay",
  chain: "eip155:84532",
  asset: "eip155:84532/erc20:0x036cbd53842c5426634e7929541ec2318f3dcf7e",
  amount: toBaseUnits("12.5", 6),
  to: "0x000000000000000000000000000000000000dEaD",
  txHash: "0x" + "ab".repeat(32),
});
const digest = await receiptDigest(statement);
const mint = await signReceiptMint(issuer, { iss: "demo-issuer", receipt: "rcpt_1", digest, independent: true });
const delivery = await signReceiptAttestation(issuer, { iss: "demo-issuer", receipt: "rcpt_1", digest, kind: "delivery", decision: "confirmed", decidedBy: "member", decidedAt: new Date() });
const keyset = await createIssuerKeyset([{ iss: "demo-issuer", publicKey: Buffer.from(issuer.publicKey).toString("base64url") }]);
const result = await verifyReceipt({ id: "rcpt_1", statement, mint, delivery }, keyset);
console.log(result.ok); // true; change any field of the statement and it is false

git clone https://github.com/AdaSouls/alma.git
cd alma
npm install
npm run build -w @adasouls/alma-core -w @adasouls/alma-manifest -w @adasouls/alma-cli
node packages/cli/dist/bin.js --help

kind: Agent
version: alma/v1
metadata:
  name: treasury-agent
identity:
  type: agent
capabilities:
  - pay
authority:
  maxTransaction:
    USDC: "1000"
counterpartyPolicy:
  minCompletedTransactions: 20
  minReputationEvidence:
    disputeRate: 0.02
  requiredCredentials:
    - kyb_verified

import { readFileSync } from "node:fs";
import { parseManifestYaml, compileManifest } from "@adasouls/alma-manifest";

const manifest = parseManifestYaml(readFileSync("alma.yaml", "utf8")); // throws AlmaValidationError on a bad manifest
const compiled = compileManifest(manifest);
console.log(compiled.delegation.scope); // { capabilities: [ 'pay' ] }
console.log(compiled.counterpartyPolicy.rules.minCompletedTransactions); // 20