Open-source platform for 3D AI agents. Turn text or a photo into a rigged, animated GLB avatar, give it an LLM brain, memory and a wallet, and embed it anywhere with one web component. Remote MCP server, x402 payments, Three.js, browser-native.
JavaScript 3d-generationai-agentsanimationavatardigital-humangenerative-aiglbgltfimage-to-3dllmmcpmcp-servermodel-context-protocolsolanatext-to-3dthreejsweb-componentswebglwebxrx402
test(knock): cover the escrow-sync endpoint that writes chain truth back to a row
nirholas2bcda569cff9
diff --git a/tests/api-knock-escrow-sync.test.js b/tests/api-knock-escrow-sync.test.jsnew file mode 100644index 000000000..4183d87cb--- /dev/null+++ b/tests/api-knock-escrow-sync.test.js@@ -0,0 +1,153 @@+// POST /api/knock/escrow-sync: keeping the cache honest about the chain.+//+// The escrow_* columns are a cache of what the program recorded, and nothing+// ever tells this server that a settlement happened: the transactions are+// signed by wallets we do not hold. So the only correct behaviour is to look,+// and to write back exactly what was found. These tests are about the two ways+// that goes wrong. Writing a state the chain did not record would let a caller+// mark their own knock refunded; refusing to write one it did record leaves a+// refunded knock sitting in an inbox looking like money on the table.++import { describe, it, expect, vi, beforeEach } from 'vitest';+import { PublicKey } from '@solana/web3.js';++const PROGRAM = 'uVX46U6sGUs6PD3339ZXbTpMyhZwkQhBLPxnvRX9ps7';+const KNOCK = '8WvZ64SL6JNss232BC78aapB2M6MjE95f9LtWfYYRn5t';+const DOOR = 'DMDKj3mSoM5rjsftGAhSbLbrAWMwmFxEkHDLsx997vk8';+const SENDER = 'TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA';+const USDC = 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v';++const state = { row: null, account: null, accountOwner: PROGRAM, rpcThrows: false, updates: [] };++vi.mock('../api/_lib/knock/store.js', () => ({+ findByEscrowKnock: async () => state.row,+ updateEscrowState: async (knock, next) => {+ state.updates.push([knock, next]);+ return { id: 'row-1', escrow_knock: knock, escrow_state: next };+ },+}));++vi.mock('../api/_lib/rate-limit.js', () => ({+ clientIp: () => '203.0.113.9',+ limits: { knockSendIp: async () => ({ success: true }) },+}));++vi.mock('../api/_lib/solana/rpc-fallback.js', () => ({+ rpcFallbackFromEnv: () => ({+ withFallback: (fn) => {+ if (state.rpcThrows) throw new Error('every provider refused');+ return fn({+ async getAccountInfo() {+ if (!state.account) return null;+ return { data: state.account, owner: { toBase58: () => state.accountOwner } };+ },+ });+ },+ }),+}));++const { default: handler } = await import('../api/knock/escrow-sync.js');++function knockAccount({ knockState = 0, expiresAt = Math.floor(Date.now() / 1000) + 3600 } = {}) {+ const buf = Buffer.alloc(205);+ Buffer.from('f9c621b06c558191', 'hex').copy(buf, 0);+ new PublicKey(DOOR).toBuffer().copy(buf, 8);+ new PublicKey(SENDER).toBuffer().copy(buf, 40);+ new PublicKey(USDC).toBuffer().copy(buf, 72);+ buf.writeBigUInt64LE(50_000n, 104);+ buf.writeUInt16LE(250, 112);+ buf.writeBigUInt64LE(7n, 114);+ buf.writeBigInt64LE(BigInt(expiresAt - 3600), 186);+ buf.writeBigInt64LE(BigInt(expiresAt), 194);+ buf[202] = knockState;+ return buf;+}++function call(body) {+ const req = {+ method: 'POST',+ url: '/api/knock/escrow-sync',+ headers: { 'content-type': 'application/json', origin: 'https://three.ws' },+ body,+ socket: { remoteAddress: '203.0.113.9' },+ };+ const res = {+ statusCode: 0,+ payload: null,+ headers: {},+ setHeader(k, v) { this.headers[String(k).toLowerCase()] = v; },+ getHeader(k) { return this.headers[String(k).toLowerCase()]; },+ removeHeader(k) { delete this.headers[String(k).toLowerCase()]; },+ writeHead(code) { this.statusCode = code; return this; },+ get headersSent() { return false; },+ get writableEnded() { return false; },+ end(chunk) {+ if (chunk) {+ try { this.payload = JSON.parse(String(chunk)); } catch { this.payload = String(chunk); }+ }+ return this;+ },+ };+ return handler(req, res).then(() => ({ status: res.statusCode, body: res.payload }));+}++beforeEach(() => {+ state.row = { id: 'row-1', escrow_knock: KNOCK, escrow_state: 'pending' };+ state.account = knockAccount();+ state.accountOwner = PROGRAM;+ state.rpcThrows = false;+ state.updates = [];+});++describe('POST /api/knock/escrow-sync', () => {+ it('writes back a settlement the chain recorded', async () => {+ state.account = knockAccount({ knockState: 1 });+ const out = await call({ knock: KNOCK });+ expect(out.status).toBe(200);+ expect(out.body.state).toBe('answered');+ expect(out.body.changed).toBe(true);+ expect(state.updates).toEqual([[KNOCK, 'answered']]);+ });++ it('writes nothing when the chain agrees with the cache', async () => {+ const out = await call({ knock: KNOCK });+ expect(out.body.state).toBe('pending');+ expect(out.body.changed).toBe(false);+ expect(state.updates).toHaveLength(0);+ });++ it('reports an expired escrow as expired while it is still pending', async () => {+ state.account = knockAccount({ expiresAt: Math.floor(Date.now() / 1000) - 10 });+ const out = await call({ knock: KNOCK });+ expect(out.body.state).toBe('pending');+ expect(out.body.expired).toBe(true);+ });++ it('refuses an escrow this platform never delivered against', async () => {+ state.row = null;+ const out = await call({ knock: KNOCK });+ expect(out.status).toBe(404);+ expect(out.body.error).toBe('unknown_escrow');+ expect(state.updates).toHaveLength(0);+ });++ it('changes nothing when an account is owned by another program', async () => {+ // A lookalike account is not evidence about our escrow, so the cached+ // state has to survive it untouched rather than being reset to pending.+ state.row.escrow_state = 'answered';+ state.accountOwner = '11111111111111111111111111111111';+ const out = await call({ knock: KNOCK });+ expect(out.status).toBe(200);+ expect(out.body.state).toBe('answered');+ expect(out.body.changed).toBe(false);+ expect(state.updates).toHaveLength(0);+ });++ it('leaves the cache alone when no RPC will answer', async () => {+ state.rpcThrows = true;+ const out = await call({ knock: KNOCK });+ expect(out.status).toBe(503);+ expect(out.body.error).toBe('chain_unreachable');+ expect(state.updates).toHaveLength(0);+ });+});