@claw-network/protocol 0.1.0

package/dist/wallet/state.js

@@ -0,0 +1,170 @@
+import { eventHashHex } from '@claw-network/core/protocol';
+export function createWalletState() {
+    return {
+        balances: {},
+        escrows: {},
+        history: [],
+    };
+}
+export function getWalletBalance(state, address) {
+    return state.balances[address] ?? createEmptyBalance();
+}
+export function applyWalletEvent(state, envelope) {
+    const next = {
+        balances: { ...state.balances },
+        escrows: { ...state.escrows },
+        history: [...state.history],
+    };
+    const type = String(envelope.type ?? '');
+    const payload = (envelope.payload ?? {});
+    const ts = typeof envelope.ts === 'number' ? envelope.ts : Date.now();
+    const hash = typeof envelope.hash === 'string' && envelope.hash.length
+        ? envelope.hash
+        : eventHashHex(envelope);
+    switch (type) {
+        case 'wallet.mint': {
+            applyMint(next, payload);
+            break;
+        }
+        case 'wallet.transfer': {
+            applyTransfer(next, payload);
+            break;
+        }
+        case 'wallet.escrow.create': {
+            applyEscrowCreate(next, payload);
+            break;
+        }
+        case 'wallet.escrow.fund': {
+            applyEscrowFund(next, payload);
+            break;
+        }
+        case 'wallet.escrow.release': {
+            applyEscrowRelease(next, payload);
+            break;
+        }
+        case 'wallet.escrow.refund': {
+            applyEscrowRefund(next, payload);
+            break;
+        }
+        default: {
+            return next;
+        }
+    }
+    next.history.push({
+        hash,
+        type,
+        ts,
+        payload,
+    });
+    return next;
+}
+function createEmptyBalance() {
+    return {
+        available: '0',
+        pending: '0',
+        locked: {
+            escrow: '0',
+            governance: '0',
+        },
+    };
+}
+function ensureBalance(state, address) {
+    const current = state.balances[address] ?? createEmptyBalance();
+    const clone = {
+        available: current.available,
+        pending: current.pending,
+        locked: {
+            escrow: current.locked.escrow,
+            governance: current.locked.governance,
+        },
+    };
+    state.balances[address] = clone;
+    return clone;
+}
+function parseAmount(value, field) {
+    try {
+        const parsed = BigInt(value);
+        if (parsed < 0n) {
+            throw new Error(`${field} must be >= 0`);
+        }
+        return parsed;
+    }
+    catch {
+        throw new Error(`${field} must be a valid integer string`);
+    }
+}
+function addAmount(current, delta, field) {
+    const base = parseAmount(current, field);
+    const next = base + delta;
+    if (next < 0n) {
+        throw new Error(`${field} would be negative`);
+    }
+    return next.toString();
+}
+function applyMint(state, payload) {
+    const amount = parseAmount(payload.amount, 'amount');
+    const toBalance = ensureBalance(state, payload.to);
+    toBalance.available = addAmount(toBalance.available, amount, 'available');
+}
+function applyTransfer(state, payload) {
+    const amount = parseAmount(payload.amount, 'amount');
+    const fee = parseAmount(payload.fee, 'fee');
+    const total = amount + fee;
+    const fromBalance = ensureBalance(state, payload.from);
+    fromBalance.available = addAmount(fromBalance.available, -total, 'available');
+    const toBalance = ensureBalance(state, payload.to);
+    toBalance.available = addAmount(toBalance.available, amount, 'available');
+}
+function applyEscrowCreate(state, payload) {
+    if (!state.escrows[payload.escrowId]) {
+        const expiresAt = typeof payload.expiresAt === 'number' && Number.isFinite(payload.expiresAt)
+            ? payload.expiresAt
+            : undefined;
+        state.escrows[payload.escrowId] = {
+            escrowId: payload.escrowId,
+            depositor: payload.depositor,
+            beneficiary: payload.beneficiary,
+            balance: '0',
+            status: 'pending',
+            expiresAt,
+        };
+    }
+}
+function applyEscrowFund(state, payload) {
+    const escrow = state.escrows[payload.escrowId];
+    if (!escrow) {
+        throw new Error('escrow not found');
+    }
+    const amount = parseAmount(payload.amount, 'amount');
+    escrow.balance = addAmount(escrow.balance, amount, 'escrow balance');
+    escrow.status = 'funded';
+    const depositor = ensureBalance(state, escrow.depositor);
+    depositor.available = addAmount(depositor.available, -amount, 'available');
+    depositor.locked.escrow = addAmount(depositor.locked.escrow, amount, 'locked escrow');
+}
+function applyEscrowRelease(state, payload) {
+    const escrow = state.escrows[payload.escrowId];
+    if (!escrow) {
+        throw new Error('escrow not found');
+    }
+    const amount = parseAmount(payload.amount, 'amount');
+    escrow.balance = addAmount(escrow.balance, -amount, 'escrow balance');
+    escrow.status = escrow.balance === '0' ? 'released' : 'releasing';
+    const depositor = ensureBalance(state, escrow.depositor);
+    depositor.locked.escrow = addAmount(depositor.locked.escrow, -amount, 'locked escrow');
+    const beneficiary = ensureBalance(state, escrow.beneficiary);
+    beneficiary.available = addAmount(beneficiary.available, amount, 'available');
+}
+function applyEscrowRefund(state, payload) {
+    const escrow = state.escrows[payload.escrowId];
+    if (!escrow) {
+        throw new Error('escrow not found');
+    }
+    const amount = parseAmount(payload.amount, 'amount');
+    escrow.balance = addAmount(escrow.balance, -amount, 'escrow balance');
+    escrow.status = escrow.balance === '0' ? 'refunded' : escrow.status;
+    const depositor = ensureBalance(state, escrow.depositor);
+    depositor.locked.escrow = addAmount(depositor.locked.escrow, -amount, 'locked escrow');
+    depositor.available = addAmount(depositor.available, amount, 'available');
+}
+//# sourceMappingURL=state.js.map

package/dist/wallet/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../src/wallet/state.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@claw-network/protocol",
+  "version": "0.1.0",
+  "description": "Protocol definitions and event envelopes for the ClawNet network",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/claw-network/clawnet.git",
+    "directory": "packages/protocol"
+  },
+  "keywords": ["clawnet", "agent", "decentralized", "protocol"],
+  "files": ["dist", "README.md"],
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./p2p": {
+      "types": "./dist/p2p/index.d.ts",
+      "default": "./dist/p2p/index.js"
+    },
+    "./identity": {
+      "types": "./dist/identity/index.d.ts",
+      "default": "./dist/identity/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -b tsconfig.json",
+    "test": "vitest run",
+    "lint": "eslint src --max-warnings=0"
+  },
+  "dependencies": {
+    "@claw-network/core": "workspace:^0.1.0",
+    "flatbuffers": "^24.3.25"
+  }
+}