@msgboard/relayer 0.0.1 → 0.0.31

package/README.md

@@ -2,6 +2,14 @@
 
 A controllable, safe-by-default pool-watcher engine for the msgboard board. Runs a heartbeat: poll a **Source**, record every item to an always-on **Sink**, filter by a **Condition**, dedup via a **Store**, then gate the **Action** based on mode.
 
+## Install
+
+```sh
+npm i @msgboard/relayer
+```
+
+`pg` is an optional peer dependency — only required if you use `postgresStore` or `postgresArchiveSink`.
+
 ## Safe by default
 
 The engine has two modes:
@@ -23,10 +31,12 @@ Sink and Store are intentionally separate: the sink runs in **both** modes; the
 ## Minimal usage
 
 ```ts
+import { http } from 'viem'
 import { Relayer, msgboardContentSource, noopAction } from '@msgboard/relayer'
 
 const relayer = new Relayer({
-  node: { rpcUrl: 'https://rpc.v4.testnet.pulsechain.com', chainId: 943 },
+  node: { transport: http('https://rpc.pulsechain.com') },
+  // chain auto-detected via eth_chainId; pass node.chain to override
   // mode defaults to 'observe' — no on-chain writes
   source: msgboardContentSource({ category: 'myapp' }),
   key: (msg) => msg.hash,
@@ -51,6 +61,54 @@ const recent = await archive.query({ chainId: 943, category: 'lorem', limit: 20
 
 `query()` filters by `chainId`, `category` (hex or decoded text), `since`/`until`, `contains` (substring match on decoded content), `limit`, and `offset`.
 
+The storage and query layer lives in [`@msgboard/history`](../history); `postgresArchiveSink` is the adapter that drives it from the relayer heartbeat. Use `@msgboard/history`'s `archiveServer` to expose the same archive over an HTTP query API.
+
+## "Write for me" relay
+
+A push-based relay pattern where clients solve proof-of-work locally and POST the result — the relay forwards it on-chain on their behalf.
+
+```ts
+import { http, isHex, type Hex } from 'viem'
+import { Relayer, httpQueueSource, forwardMessageAction, defaultLogger } from '@msgboard/relayer'
+
+const queue = httpQueueSource<Hex>({
+  port: 3001,
+  token: process.env.RELAY_TOKEN,
+  parse: (body) => {
+    const { rlp } = body as { rlp: string }
+    if (!isHex(rlp)) throw new Error('expected hex rlp')
+    return rlp as Hex
+  },
+})
+
+const relayer = new Relayer<Hex>({
+  node: { transport: http('https://rpc.pulsechain.com') },
+  mode: 'live',
+  source: queue,
+  key: (rlp) => rlp,
+  action: forwardMessageAction(),
+  logger: defaultLogger('relay'),
+})
+
+relayer.start()
+```
+
+Clients submit with:
+
+```sh
+curl -X POST http://localhost:3001/submit \
+  -H 'Content-Type: application/json' \
+  -d '{"rlp":"0x..."}'
+```
+
+The `rlp` value comes from the SDK client's `doPoW()` result: `work.message`. The relay calls `msgboard_addMessage` with it directly — no wallet, no second proof-of-work.
+
+`httpQueueSource` buffers POSTed items in memory and drains them on each heartbeat tick. An optional `token` field enables bearer-token auth. See `examples/write-for-me.ts` for a full runnable version.
+
+### Transform anything
+
+Because `httpQueueSource` is generic and `forwardMessageAction` only needs a `Hex` RLP, you can build relays for arbitrary protocols by adding a transform step: accept whatever your protocol produces, convert it to a `msgboard_addMessage`-compatible RLP in `parse`, and let the relayer forward it.
+
 ## Example relayers
 
 | Relayer | source | store | sink | action (live only) | demonstrates |
@@ -59,10 +117,11 @@ const recent = await archive.query({ chainId: 943, category: 'lorem', limit: 20
 | Bridge watcher (`bridge.ts`) | `bridgeAffirmationSource` (per chain) | memory-ttl | — | `submitMessageAction` | finalized event source, multi-node |
 | Spam writer (`spam.ts`) | `generatedSource(sentence)` | noop | — | `submitMessageAction` | producer source, noop dedup |
 | Archivist | all content | — | `postgresArchiveSink` 1yr | `noopAction` | sink-only; records in observe mode |
+| "Write for me" relay (`write-for-me.ts`) | `httpQueueSource` (POSTed RLP) | noop | — | `forwardMessageAction` | push-based, client-side PoW |
 | Cross-chain mirror | content on 369 | memory-ttl | — | `submitMessageAction` on 943 | source node ≠ action node |
 | Moderation flagger | all content + blocklist predicate | — | `postgresSink('flagged')` | `noopAction` | condition + sink, no action |
 
-See `examples/` for runnable code for the archivist, mirror, and flagger.
+See `examples/` for runnable code for the archivist, mirror, flagger, and write-for-me relay.
 
 ## Known limitations
 

package/dist/actions/forward-message.d.ts

@@ -0,0 +1,13 @@
+import type { Hex } from 'viem';
+import type { RelayerAction } from '../types.js';
+/**
+ * Forwards a pre-computed RLP-encoded message to the board without doing
+ * proof-of-work. The item must already be a valid RLP hex string produced by
+ * the client's `doPoW` → `message` field.
+ *
+ * Use this with `httpQueueSource` to build a "write for you" relay: clients
+ * solve their own proof-of-work locally then POST the result; the relay
+ * submits it on-chain.
+ */
+export declare const forwardMessageAction: () => RelayerAction<Hex>;
+//# sourceMappingURL=forward-message.d.ts.map

package/dist/actions/forward-message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forward-message.d.ts","sourceRoot":"","sources":["../../src/actions/forward-message.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,MAAM,CAAA;AAC/B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAEhD;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,QAAO,aAAa,CAAC,GAAG,CAMvD,CAAA"}

package/dist/actions/forward-message.js

@@ -0,0 +1,17 @@
+/**
+ * Forwards a pre-computed RLP-encoded message to the board without doing
+ * proof-of-work. The item must already be a valid RLP hex string produced by
+ * the client's `doPoW` → `message` field.
+ *
+ * Use this with `httpQueueSource` to build a "write for you" relay: clients
+ * solve their own proof-of-work locally then POST the result; the relay
+ * submits it on-chain.
+ */
+export const forwardMessageAction = () => ({
+    describe: (item) => `forward pre-computed message ${item.slice(0, 10)}…`,
+    execute: async (item, context) => {
+        const hash = await context.client.addMessage(item);
+        return { ok: true, ref: hash };
+    },
+});
+//# sourceMappingURL=forward-message.js.map

package/dist/actions/forward-message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"forward-message.js","sourceRoot":"","sources":["../../src/actions/forward-message.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAuB,EAAE,CAAC,CAAC;IAC7D,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,gCAAgC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG;IACxE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE;QAC/B,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAA;QAClD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,CAAA;IAChC,CAAC;CACF,CAAC,CAAA"}

package/dist/actions/send-value.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"send-value.d.ts","sourceRoot":"","sources":["../../src/actions/send-value.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,OAAO,EACZ,KAAK,YAAY,EAIlB,MAAM,MAAM,CAAA;AACb,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAEhE,MAAM,MAAM,sBAAsB,CAAC,CAAC,IAAI;IACtC,2DAA2D;IAC3D,OAAO,EAAE,OAAO,CAAA;IAChB,iDAAiD;IACjD,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,cAAc,KAAK,OAAO,CAAA;IACxD,8BAA8B;IAC9B,MAAM,EAAE,MAAM,CAAA;IACd,kCAAkC;IAClC,GAAG,EAAE,MAAM,CAAA;IACX,6DAA6D;IAC7D,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,YAAY,CAAA;CAC1D,CAAA;AAED,qFAAqF;AACrF,eAAO,MAAM,eAAe,GAAI,CAAC,EAAE,SAAS,sBAAsB,CAAC,CAAC,CAAC,KAAG,aAAa,CAAC,CAAC,CAyBtF,CAAA"}
+{"version":3,"file":"send-value.d.ts","sourceRoot":"","sources":["../../src/actions/send-value.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,OAAO,EACZ,KAAK,YAAY,EAGlB,MAAM,MAAM,CAAA;AACb,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAEhE,MAAM,MAAM,sBAAsB,CAAC,CAAC,IAAI;IACtC,2DAA2D;IAC3D,OAAO,EAAE,OAAO,CAAA;IAChB,iDAAiD;IACjD,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,cAAc,KAAK,OAAO,CAAA;IACxD,8BAA8B;IAC9B,MAAM,EAAE,MAAM,CAAA;IACd,kCAAkC;IAClC,GAAG,EAAE,MAAM,CAAA;IACX,6DAA6D;IAC7D,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,YAAY,CAAA;CAC1D,CAAA;AAED,qFAAqF;AACrF,eAAO,MAAM,eAAe,GAAI,CAAC,EAAE,SAAS,sBAAsB,CAAC,CAAC,CAAC,KAAG,aAAa,CAAC,CAAC,CAyBtF,CAAA"}

package/dist/actions/send-value.js

@@ -1,11 +1,11 @@
-import { createWalletClient, formatEther, http, } from 'viem';
+import { createWalletClient, formatEther, } from 'viem';
 /** Sends native coin to an address derived from each item; waits for the receipt. */
 export const sendValueAction = (options) => {
     const makeWallet = (context) => options.walletFactory?.(context) ??
         createWalletClient({
             account: options.account,
             chain: context.chain,
-            transport: http(context.node.rpcUrl, { timeout: 30_000 }),
+            transport: context.node.transport,
         });
     return {
         describe: (item, context) => `send ${formatEther(options.amount)} to ${options.recipient(item, context)}`,

package/dist/actions/send-value.js.map

@@ -1 +1 @@
-{"version":3,"file":"send-value.js","sourceRoot":"","sources":["../../src/actions/send-value.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,kBAAkB,EAClB,WAAW,EACX,IAAI,GACL,MAAM,MAAM,CAAA;AAgBb,qFAAqF;AACrF,MAAM,CAAC,MAAM,eAAe,GAAG,CAAI,OAAkC,EAAoB,EAAE;IACzF,MAAM,UAAU,GAAG,CAAC,OAAuB,EAAgB,EAAE,CAC3D,OAAO,CAAC,aAAa,EAAE,CAAC,OAAO,CAAC;QAChC,kBAAkB,CAAC;YACjB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;SAC1D,CAAC,CAAA;IACJ,OAAO;QACL,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAC1B,QAAQ,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE;QAC9E,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE;YAC/B,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,CAAC,CAAA;YAClC,MAAM,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;YAC3C,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC;gBACxC,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,EAAE;gBACF,KAAK,EAAE,OAAO,CAAC,MAAM;gBACrB,GAAG,EAAE,OAAO,CAAC,GAAG;aACjB,CAAC,CAAA;YACF,MAAM,OAAO,CAAC,YAAY,CAAC,yBAAyB,CAAC,EAAE,IAAI,EAAE,CAAC,CAAA;YAC9D,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,CAAA;QAChC,CAAC;KACF,CAAA;AACH,CAAC,CAAA"}
+{"version":3,"file":"send-value.js","sourceRoot":"","sources":["../../src/actions/send-value.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,kBAAkB,EAClB,WAAW,GACZ,MAAM,MAAM,CAAA;AAgBb,qFAAqF;AACrF,MAAM,CAAC,MAAM,eAAe,GAAG,CAAI,OAAkC,EAAoB,EAAE;IACzF,MAAM,UAAU,GAAG,CAAC,OAAuB,EAAgB,EAAE,CAC3D,OAAO,CAAC,aAAa,EAAE,CAAC,OAAO,CAAC;QAChC,kBAAkB,CAAC;YACjB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,SAAS,EAAE,OAAO,CAAC,IAAI,CAAC,SAAS;SAClC,CAAC,CAAA;IACJ,OAAO;QACL,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAC1B,QAAQ,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE;QAC9E,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE;YAC/B,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,CAAC,CAAA;YAClC,MAAM,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;YAC3C,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC;gBACxC,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,EAAE;gBACF,KAAK,EAAE,OAAO,CAAC,MAAM;gBACrB,GAAG,EAAE,OAAO,CAAC,GAAG;aACjB,CAAC,CAAA;YACF,MAAM,OAAO,CAAC,YAAY,CAAC,yBAAyB,CAAC,EAAE,IAAI,EAAE,CAAC,CAAA;YAC9D,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,CAAA;QAChC,CAAC;KACF,CAAA;AACH,CAAC,CAAA"}

package/dist/index.d.ts

@@ -14,7 +14,10 @@ export { msgboardContentSource } from './sources/msgboard-content.js';
 export { bridgeAffirmationSource } from './sources/bridge-affirmation.js';
 export { generatedSource } from './sources/generated.js';
 export { submitMessageAction } from './actions/submit-message.js';
+export { forwardMessageAction } from './actions/forward-message.js';
 export { sendValueAction } from './actions/send-value.js';
 export { webhookAction } from './actions/webhook.js';
 export { noopAction } from './actions/noop.js';
+export { httpQueueSource } from './sources/http-queue.js';
+export type { HttpQueueSource, HttpQueueSourceOptions } from './sources/http-queue.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3C,YAAY,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,YAAY,EACV,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,UAAU,EACV,WAAW,EACX,WAAW,EACX,WAAW,EACX,aAAa,EACb,YAAY,EACZ,UAAU,GACX,MAAM,YAAY,CAAA;AAEnB,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACpD,YAAY,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAErD,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAA;AACjE,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAA;AAClG,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAElD,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAA;AACrE,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAA;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAExD,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAA;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3C,YAAY,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,YAAY,EACV,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,UAAU,EACV,WAAW,EACX,WAAW,EACX,WAAW,EACX,aAAa,EACb,YAAY,EACZ,UAAU,GACX,MAAM,YAAY,CAAA;AAEnB,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACpD,YAAY,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAErD,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAA;AACjE,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAA;AAClG,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAElD,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAA;AACrE,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAA;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAExD,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAA;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAA;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAE9C,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AACzD,YAAY,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAA"}

package/dist/index.js

@@ -10,7 +10,9 @@ export { msgboardContentSource } from './sources/msgboard-content.js';
 export { bridgeAffirmationSource } from './sources/bridge-affirmation.js';
 export { generatedSource } from './sources/generated.js';
 export { submitMessageAction } from './actions/submit-message.js';
+export { forwardMessageAction } from './actions/forward-message.js';
 export { sendValueAction } from './actions/send-value.js';
 export { webhookAction } from './actions/webhook.js';
 export { noopAction } from './actions/noop.js';
+export { httpQueueSource } from './sources/http-queue.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAE3C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAgB1C,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAGpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAA;AAEjE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAElD,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAA;AACrE,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAA;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAExD,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAA;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAE3C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAgB1C,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAGpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAA;AAEjE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAElD,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAA;AACrE,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAA;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAExD,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAA;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAA;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAE9C,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA"}

package/dist/relayer.d.ts

@@ -6,7 +6,7 @@ import type { RelayerConfig, RelayerMode, TickReport } from './types.js';
 export declare class Relayer<T> {
     private readonly config;
     private readonly logger;
-    private readonly context;
+    private contextPromise;
     private readonly intervalMs;
     private readonly pruneEveryTicks;
     private tickCount;
@@ -15,6 +15,7 @@ export declare class Relayer<T> {
     private abort;
     constructor(config: RelayerConfig<T>);
     get mode(): RelayerMode;
+    private ensureContext;
     /** Runs a single tick and returns a report. Used by tests and one-shot runs. */
     runOnce(): Promise<TickReport>;
     /** Begins the poll loop. Idempotent — a second call is a no-op while running. */

package/dist/relayer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"relayer.d.ts","sourceRoot":"","sources":["../src/relayer.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAkB,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAuCxF;;;GAGG;AACH,qBAAa,OAAO,CAAC,CAAC;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAQ;IACnC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAQ;IACxC,OAAO,CAAC,SAAS,CAAI;IACrB,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,WAAW,CAA6B;IAChD,OAAO,CAAC,KAAK,CAA+B;gBAEhC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC;IAQpC,IAAI,IAAI,IAAI,WAAW,CAEtB;IAED,gFAAgF;IAC1E,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC;IAmBpC,iFAAiF;IACjF,KAAK,IAAI,IAAI;IAQb,oDAAoD;IAC9C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YASb,IAAI;YAYJ,UAAU;YAWV,UAAU;YAMV,UAAU;YAcV,SAAS;YAiBT,UAAU;CAKzB"}
+{"version":3,"file":"relayer.d.ts","sourceRoot":"","sources":["../src/relayer.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAkB,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAoDxF;;;GAGG;AACH,qBAAa,OAAO,CAAC,CAAC;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAC/B,OAAO,CAAC,cAAc,CAAuC;IAC7D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAQ;IACnC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAQ;IACxC,OAAO,CAAC,SAAS,CAAI;IACrB,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,WAAW,CAA6B;IAChD,OAAO,CAAC,KAAK,CAA+B;gBAEhC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC;IAOpC,IAAI,IAAI,IAAI,WAAW,CAEtB;IAED,OAAO,CAAC,aAAa;IAOrB,gFAAgF;IAC1E,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC;IAoBpC,iFAAiF;IACjF,KAAK,IAAI,IAAI;IAQb,oDAAoD;IAC9C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YASb,IAAI;YAYJ,UAAU;YAWV,UAAU;YAMV,UAAU;YAeV,SAAS;YAiBT,UAAU;CAKzB"}

package/dist/relayer.js

@@ -1,19 +1,30 @@
-import { createPublicClient, http } from 'viem';
+import { createPublicClient } from 'viem';
 import { MsgBoardClient } from '@msgboard/sdk';
 import { resolveChain } from './chains.js';
 import { defaultLogger } from './logger.js';
 const DEFAULT_INTERVAL_MS = 30_000;
 const DEFAULT_PRUNE_EVERY_TICKS = 30;
+/** Calls eth_chainId on the node and returns the numeric chain id. */
+const detectChainId = async (transport) => {
+    const probe = createPublicClient({ transport });
+    return probe.getChainId();
+};
 /** Builds the runtime context (viem + SDK clients) for a relayer config. */
-const buildContext = (config, logger) => {
-    const chain = resolveChain(config.node.chainId);
-    const publicClient = createPublicClient({
-        chain,
-        transport: http(config.node.rpcUrl, { timeout: 30_000 }),
-    });
+const buildContext = async (config, logger) => {
+    const node = config.node;
+    const chain = node.chain ?? await (async () => {
+        const id = await detectChainId(node.transport);
+        try {
+            return resolveChain(id);
+        }
+        catch {
+            throw new Error(`detected chain ${id} from the node is not a known network — pass node.chain explicitly to support it`);
+        }
+    })();
+    const publicClient = createPublicClient({ chain, transport: node.transport });
     const client = new MsgBoardClient(publicClient);
     return {
-        node: config.node,
+        node,
         mode: config.mode ?? 'observe',
         chain,
         publicClient,
@@ -44,7 +55,7 @@ const sleep = (ms, signal) => {
 export class Relayer {
     config;
     logger;
-    context;
+    contextPromise = null;
     intervalMs;
     pruneEveryTicks;
     tickCount = 0;
@@ -54,15 +65,21 @@ export class Relayer {
     constructor(config) {
         this.config = config;
         this.logger = config.logger ?? defaultLogger('relayer');
-        this.context = buildContext(config, this.logger);
         this.intervalMs = config.intervalMs ?? DEFAULT_INTERVAL_MS;
         this.pruneEveryTicks = config.pruneEveryTicks ?? DEFAULT_PRUNE_EVERY_TICKS;
     }
     get mode() {
-        return this.context.mode;
+        return this.config.mode ?? 'observe';
+    }
+    ensureContext() {
+        if (!this.contextPromise) {
+            this.contextPromise = buildContext(this.config, this.logger);
+        }
+        return this.contextPromise;
     }
     /** Runs a single tick and returns a report. Used by tests and one-shot runs. */
     async runOnce() {
+        const ctx = await this.ensureContext();
         const report = {
             polled: 0,
             recorded: 0,
@@ -71,10 +88,10 @@ export class Relayer {
             described: 0,
             deduped: 0,
         };
-        const items = await this.config.source.poll(this.context);
+        const items = await this.config.source.poll(ctx);
         report.polled = items.length;
         for (const item of items) {
-            await this.handleItem(item, report);
+            await this.handleItem(item, report, ctx);
         }
         this.tickCount += 1;
         await this.maybePrune();
@@ -112,26 +129,26 @@ export class Relayer {
             await sleep(this.intervalMs, signal);
         }
     }
-    async handleItem(item, report) {
-        await this.recordItem(item, report);
-        const eligible = await this.isEligible(item);
+    async handleItem(item, report, ctx) {
+        await this.recordItem(item, report, ctx);
+        const eligible = await this.isEligible(item, ctx);
         if (!eligible.proceed) {
             if (eligible.reason === 'deduped')
                 report.deduped += 1;
             return;
         }
         report.eligible += 1;
-        await this.actOnItem(item, report);
+        await this.actOnItem(item, report, ctx);
     }
-    async recordItem(item, report) {
+    async recordItem(item, report, ctx) {
         if (!this.config.sink)
             return;
-        await this.config.sink.record(item, this.context);
+        await this.config.sink.record(item, ctx);
         report.recorded += 1;
     }
-    async isEligible(item) {
+    async isEligible(item, ctx) {
         if (this.config.condition) {
-            const ok = await this.config.condition(item, this.context);
+            const ok = await this.config.condition(item, ctx);
             if (!ok)
                 return { proceed: false, reason: 'condition' };
         }
@@ -142,14 +159,14 @@ export class Relayer {
         }
         return { proceed: true };
     }
-    async actOnItem(item, report) {
-        if (this.context.mode === 'observe') {
-            this.logger('observe: %s', this.config.action.describe(item, this.context));
+    async actOnItem(item, report, ctx) {
+        if (ctx.mode === 'observe') {
+            this.logger('observe: %s', this.config.action.describe(item, ctx));
             report.described += 1;
             return;
         }
         try {
-            const result = await this.config.action.execute(item, this.context);
+            const result = await this.config.action.execute(item, ctx);
             report.executed += 1;
             if (this.config.store) {
                 await this.config.store.remember(this.config.key(item), result);

package/dist/relayer.js.map

@@ -1 +1 @@
-{"version":3,"file":"relayer.js","sourceRoot":"","sources":["../src/relayer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"relayer.js","sourceRoot":"","sources":["../src/relayer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAkB,MAAM,MAAM,CAAA;AACzD,OAAO,EAAE,cAAc,EAAiB,MAAM,eAAe,CAAA;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,EAAE,aAAa,EAAe,MAAM,aAAa,CAAA;AAGxD,MAAM,mBAAmB,GAAG,MAAM,CAAA;AAClC,MAAM,yBAAyB,GAAG,EAAE,CAAA;AAEpC,sEAAsE;AACtE,MAAM,aAAa,GAAG,KAAK,EAAE,SAAoB,EAAmB,EAAE;IACpE,MAAM,KAAK,GAAG,kBAAkB,CAAC,EAAE,SAAS,EAAE,CAAC,CAAA;IAC/C,OAAO,KAAK,CAAC,UAAU,EAAE,CAAA;AAC3B,CAAC,CAAA;AAED,4EAA4E;AAC5E,MAAM,YAAY,GAAG,KAAK,EAAK,MAAwB,EAAE,MAAc,EAA2B,EAAE;IAClG,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAA;IACxB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,IAAI,EAAE;QAC5C,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;QAC9C,IAAI,CAAC;YACH,OAAO,YAAY,CAAC,EAAE,CAAC,CAAA;QACzB,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,KAAK,CACb,kBAAkB,EAAE,kFAAkF,CACvG,CAAA;QACH,CAAC;IACH,CAAC,CAAC,EAAE,CAAA;IACJ,MAAM,YAAY,GAAG,kBAAkB,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAA;IAC7E,MAAM,MAAM,GAAG,IAAI,cAAc,CAAC,YAAmC,CAAC,CAAA;IACtE,OAAO;QACL,IAAI;QACJ,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,SAAS;QAC9B,KAAK;QACL,YAAY;QACZ,MAAM;QACN,MAAM;KACP,CAAA;AACH,CAAC,CAAA;AAED,gEAAgE;AAChE,MAAM,KAAK,GAAG,CAAC,EAAU,EAAE,MAAmB,EAAiB,EAAE;IAC/D,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,IAAI,MAAM,CAAC,OAAO;YAAE,OAAO,OAAO,EAAE,CAAA;QACpC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;YAC5C,OAAO,EAAE,CAAA;QACX,CAAC,EAAE,EAAE,CAAC,CAAA;QACN,MAAM,OAAO,GAAG,GAAG,EAAE;YACnB,YAAY,CAAC,KAAK,CAAC,CAAA;YACnB,OAAO,EAAE,CAAA;QACX,CAAC,CAAA;QACD,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;IAC3D,CAAC,CAAC,CAAA;AACJ,CAAC,CAAA;AAED;;;GAGG;AACH,MAAM,OAAO,OAAO;IACD,MAAM,CAAkB;IACxB,MAAM,CAAQ;IACvB,cAAc,GAAmC,IAAI,CAAA;IAC5C,UAAU,CAAQ;IAClB,eAAe,CAAQ;IAChC,SAAS,GAAG,CAAC,CAAA;IACb,OAAO,GAAG,KAAK,CAAA;IACf,WAAW,GAAyB,IAAI,CAAA;IACxC,KAAK,GAA2B,IAAI,CAAA;IAE5C,YAAY,MAAwB;QAClC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;QACpB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,aAAa,CAAC,SAAS,CAAC,CAAA;QACvD,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,mBAAmB,CAAA;QAC1D,IAAI,CAAC,eAAe,GAAG,MAAM,CAAC,eAAe,IAAI,yBAAyB,CAAA;IAC5E,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,SAAS,CAAA;IACtC,CAAC;IAEO,aAAa;QACnB,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;YACzB,IAAI,CAAC,cAAc,GAAG,YAAY,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;QAC9D,CAAC;QACD,OAAO,IAAI,CAAC,cAAc,CAAA;IAC5B,CAAC;IAED,gFAAgF;IAChF,KAAK,CAAC,OAAO;QACX,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE,CAAA;QACtC,MAAM,MAAM,GAAe;YACzB,MAAM,EAAE,CAAC;YACT,QAAQ,EAAE,CAAC;YACX,QAAQ,EAAE,CAAC;YACX,QAAQ,EAAE,CAAC;YACX,SAAS,EAAE,CAAC;YACZ,OAAO,EAAE,CAAC;SACX,CAAA;QACD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAChD,MAAM,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAA;QAC5B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,CAAA;QAC1C,CAAC;QACD,IAAI,CAAC,SAAS,IAAI,CAAC,CAAA;QACnB,MAAM,IAAI,CAAC,UAAU,EAAE,CAAA;QACvB,OAAO,MAAM,CAAA;IACf,CAAC;IAED,iFAAiF;IACjF,KAAK;QACH,IAAI,IAAI,CAAC,OAAO;YAAE,OAAM;QACxB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAA;QACnB,IAAI,CAAC,KAAK,GAAG,IAAI,eAAe,EAAE,CAAA;QAClC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAA;QAChC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IACtC,CAAC;IAED,oDAAoD;IACpD,KAAK,CAAC,IAAI;QACR,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAM;QACzB,IAAI,CAAC,OAAO,GAAG,KAAK,CAAA;QACpB,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,CAAA;QACnB,MAAM,IAAI,CAAC,WAAW,CAAA;QACtB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAA;QACvB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAA;IACnB,CAAC;IAEO,KAAK,CAAC,IAAI,CAAC,MAAmB;QACpC,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACvB,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,OAAO,EAAE,CAAA;YACtB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,MAAM,CAAC,iBAAiB,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAA;YAChF,CAAC;YACD,IAAI,MAAM,CAAC,OAAO;gBAAE,OAAM;YAC1B,MAAM,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAA;QACtC,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,UAAU,CAAC,IAAO,EAAE,MAAkB,EAAE,GAAmB;QACvE,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,CAAA;QACxC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;QACjD,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;YACtB,IAAI,QAAQ,CAAC,MAAM,KAAK,SAAS;gBAAE,MAAM,CAAC,OAAO,IAAI,CAAC,CAAA;YACtD,OAAM;QACR,CAAC;QACD,MAAM,CAAC,QAAQ,IAAI,CAAC,CAAA;QACpB,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,CAAA;IACzC,CAAC;IAEO,KAAK,CAAC,UAAU,CAAC,IAAO,EAAE,MAAkB,EAAE,GAAmB;QACvE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI;YAAE,OAAM;QAC7B,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;QACxC,MAAM,CAAC,QAAQ,IAAI,CAAC,CAAA;IACtB,CAAC;IAEO,KAAK,CAAC,UAAU,CACtB,IAAO,EACP,GAAmB;QAEnB,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;YAC1B,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;YACjD,IAAI,CAAC,EAAE;gBAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,CAAA;QACzD,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YACtB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAA;YAC/D,IAAI,IAAI;gBAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,CAAA;QACxD,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;IAC1B,CAAC;IAEO,KAAK,CAAC,SAAS,CAAC,IAAO,EAAE,MAAkB,EAAE,GAAmB;QACtE,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC3B,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAA;YAClE,MAAM,CAAC,SAAS,IAAI,CAAC,CAAA;YACrB,OAAM;QACR,CAAC;QACD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;YAC1D,MAAM,CAAC,QAAQ,IAAI,CAAC,CAAA;YACpB,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;gBACtB,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAA;YACjE,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,mBAAmB,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAA;QAClF,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,UAAU;QACtB,IAAI,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,eAAe,KAAK,CAAC;YAAE,OAAM;QACvD,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAA;QAClC,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAA;IACnC,CAAC;CACF"}

package/dist/sinks/postgres-archive.d.ts

@@ -1,42 +1,19 @@
+import type { ArchiveQuery, ArchiveRetention, ArchivedMessage } from '@msgboard/history';
 import type { RPCMessage } from '@msgboard/sdk';
 import type { RelayerSink } from '../types.js';
 import type { Queryable } from '../stores/postgres.js';
-export type ArchiveRetention = {
-    /** Rows older than this many days are pruned. */
-    days: number;
-};
+export type { ArchiveQuery, ArchiveRetention, ArchivedMessage };
 export type PostgresArchiveOptions = {
     pool: Queryable;
     retention: ArchiveRetention;
 };
-/** Filters for querying the historical archive. */
-export type ArchiveQuery = {
-    chainId?: number;
-    /** A bytes32 hex category or its decoded text. */
-    category?: string;
-    since?: Date;
-    until?: Date;
-    /** Substring match on decoded content. */
-    contains?: string;
-    limit?: number;
-    offset?: number;
-};
-/** A row of the historical archive. */
-export type ArchivedMessage = {
-    hash: string;
-    chain_id: number;
-    category: string | null;
-    category_text: string | null;
-    data: string | null;
-    content: string | null;
-    block_number: string | null;
-    block_hash: string | null;
-    first_seen_at: string;
-};
 /**
- * The historical index of every message seen flowing through the board. An
- * ever-growing table, pruned to a retention window (default one year). `record`
- * is idempotent on `(hash, chain_id)`. Call `migrate()` once at startup.
+ * The historical index of every message seen flowing through the board, backed by
+ * `@msgboard/history`. Adapts that archive to the relayer's sink interface: `record`
+ * is driven by the relayer heartbeat (chain id taken from the tick context), while
+ * `migrate`/`prune`/`query` pass straight through. An ever-growing table pruned to a
+ * retention window (default one year); `record` is idempotent on `(hash, chain_id)`.
+ * Call `migrate()` once at startup.
  */
 export declare const postgresArchiveSink: (options: PostgresArchiveOptions) => RelayerSink<RPCMessage> & {
     migrate(): Promise<void>;

package/dist/sinks/postgres-archive.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"postgres-archive.d.ts","sourceRoot":"","sources":["../../src/sinks/postgres-archive.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAC/C,OAAO,KAAK,EAAkB,WAAW,EAAE,MAAM,aAAa,CAAA;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AAEtD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED,MAAM,MAAM,sBAAsB,GAAG;IACnC,IAAI,EAAE,SAAS,CAAA;IACf,SAAS,EAAE,gBAAgB,CAAA;CAC5B,CAAA;AAED,mDAAmD;AACnD,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,IAAI,CAAA;IACZ,KAAK,CAAC,EAAE,IAAI,CAAA;IACZ,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,uCAAuC;AACvC,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,aAAa,EAAE,MAAM,CAAA;CACtB,CAAA;AAeD;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAC9B,SAAS,sBAAsB,KAC9B,WAAW,CAAC,UAAU,CAAC,GAAG;IAC3B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACxB,KAAK,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAAA;CA+ExD,CAAA"}
+{"version":3,"file":"postgres-archive.d.ts","sourceRoot":"","sources":["../../src/sinks/postgres-archive.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACxF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAC/C,OAAO,KAAK,EAAkB,WAAW,EAAE,MAAM,aAAa,CAAA;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AAItD,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,CAAA;AAE/D,MAAM,MAAM,sBAAsB,GAAG;IACnC,IAAI,EAAE,SAAS,CAAA;IACf,SAAS,EAAE,gBAAgB,CAAA;CAC5B,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,GAC9B,SAAS,sBAAsB,KAC9B,WAAW,CAAC,UAAU,CAAC,GAAG;IAC3B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACxB,KAAK,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAAA;CASxD,CAAA"}

package/dist/sinks/postgres-archive.js

@@ -1,85 +1,19 @@
-import { hexToString } from 'viem';
-/** Decodes a hex blob to text, stripping null padding and returning null if not printable. */
-const tryDecodeText = (hex) => {
-    try {
-        const text = hexToString(hex).replace(/\0+$/g, '').trim();
-        if (text.length === 0)
-            return null;
-        // Reject blobs with non-printable control characters
-        if (/[\x00-\x1f\x7f]/u.test(text))
-            return null;
-        return text;
-    }
-    catch {
-        return null;
-    }
-};
+import { createArchive } from '@msgboard/history';
 /**
- * The historical index of every message seen flowing through the board. An
- * ever-growing table, pruned to a retention window (default one year). `record`
- * is idempotent on `(hash, chain_id)`. Call `migrate()` once at startup.
+ * The historical index of every message seen flowing through the board, backed by
+ * `@msgboard/history`. Adapts that archive to the relayer's sink interface: `record`
+ * is driven by the relayer heartbeat (chain id taken from the tick context), while
+ * `migrate`/`prune`/`query` pass straight through. An ever-growing table pruned to a
+ * retention window (default one year); `record` is idempotent on `(hash, chain_id)`.
+ * Call `migrate()` once at startup.
  */
 export const postgresArchiveSink = (options) => {
-    const { pool } = options;
-    const retentionDays = options.retention.days;
-    const migrate = async () => {
-        await pool.query(`CREATE TABLE IF NOT EXISTS message_archive (
-        hash          TEXT NOT NULL,
-        chain_id      INTEGER NOT NULL,
-        category      TEXT,
-        category_text TEXT,
-        data          TEXT,
-        content       TEXT,
-        block_number  BIGINT,
-        block_hash    TEXT,
-        first_seen_at TIMESTAMPTZ NOT NULL DEFAULT now(),
-        PRIMARY KEY (hash, chain_id)
-      )`);
-        await pool.query(`CREATE INDEX IF NOT EXISTS message_archive_seen_idx ON message_archive (first_seen_at)`);
-        await pool.query(`CREATE INDEX IF NOT EXISTS message_archive_chain_seen ON message_archive (chain_id, first_seen_at)`);
-        await pool.query(`CREATE INDEX IF NOT EXISTS message_archive_category_idx ON message_archive (category)`);
-    };
-    const record = async (message, context) => {
-        await pool.query(`INSERT INTO message_archive
-        (hash, chain_id, category, category_text, data, content, block_number, block_hash)
-       VALUES ($1, $2, $3, $4, $5, $6, $7, $8)
-       ON CONFLICT (hash, chain_id) DO NOTHING`, [
-            message.hash,
-            context.node.chainId,
-            message.category,
-            tryDecodeText(message.category),
-            message.data,
-            tryDecodeText(message.data),
-            BigInt(message.blockNumber).toString(),
-            message.blockHash,
-        ]);
-    };
-    const prune = async () => {
-        await pool.query(`DELETE FROM message_archive WHERE first_seen_at < now() - INTERVAL '${retentionDays} days'`);
-    };
-    const query = async (filter) => {
-        const clauses = [];
-        const params = [];
-        const add = (clause, value) => {
-            params.push(value);
-            clauses.push(clause.replace(/\$\?/g, `$${params.length}`));
-        };
-        if (filter.chainId !== undefined)
-            add('chain_id = $?', filter.chainId);
-        if (filter.category !== undefined)
-            add('(category = $? OR category_text = $?)', filter.category);
-        if (filter.since)
-            add('first_seen_at >= $?', filter.since.toISOString());
-        if (filter.until)
-            add('first_seen_at <= $?', filter.until.toISOString());
-        if (filter.contains)
-            add('content ILIKE $?', `%${filter.contains}%`);
-        const where = clauses.length > 0 ? `WHERE ${clauses.join(' AND ')}` : '';
-        const limit = Math.min(Math.max(Number.parseInt(String(filter.limit ?? 100), 10) || 100, 1), 1000);
-        const offset = Math.max(Number.parseInt(String(filter.offset ?? 0), 10) || 0, 0);
-        const { rows } = await pool.query(`SELECT hash, chain_id, category, category_text, data, content, block_number, block_hash, first_seen_at FROM message_archive ${where} ORDER BY first_seen_at DESC LIMIT ${limit} OFFSET ${offset}`, params);
-        return rows;
+    const archive = createArchive({ pool: options.pool, retention: options.retention });
+    return {
+        migrate: archive.migrate,
+        prune: archive.prune,
+        query: archive.query,
+        record: (message, context) => archive.record(message, context.chain.id),
     };
-    return { record, prune, migrate, query };
 };
 //# sourceMappingURL=postgres-archive.js.map

package/dist/sinks/postgres-archive.js.map

@@ -1 +1 @@
-{"version":3,"file":"postgres-archive.js","sourceRoot":"","sources":["../../src/sinks/postgres-archive.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"postgres-archive.js","sourceRoot":"","sources":["../../src/sinks/postgres-archive.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAejD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,OAA+B,EAI/B,EAAE;IACF,MAAM,OAAO,GAAG,aAAa,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAA;IACnF,OAAO;QACL,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,MAAM,EAAE,CAAC,OAAmB,EAAE,OAAuB,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;KACpG,CAAA;AACH,CAAC,CAAA"}

package/dist/sources/http-queue.d.ts

@@ -0,0 +1,55 @@
+import type { RelayerSource } from '../types.js';
+export type HttpQueueSourceOptions<T> = {
+    /** Port to listen on. Defaults to 3001. */
+    port?: number;
+    /**
+     * Host / interface to bind. Defaults to `'127.0.0.1'` (loopback only).
+     * Set to `'0.0.0.0'` for LAN/Internet exposure — requires `token` to be
+     * set, or the server refuses to start.
+     */
+    host?: string;
+    /**
+     * Parses the raw JSON body into a typed item. Throw to reject.
+     * The returned item is added to the next poll batch.
+     */
+    parse: (body: unknown) => T;
+    /**
+     * Optional bearer token — requests without `Authorization: Bearer <token>`
+     * receive a 401 and are not queued.
+     */
+    token?: string;
+    /**
+     * Maximum number of items held in memory before new submissions are
+     * rejected with 429. Defaults to 1000. Set to 0 to disable the cap.
+     */
+    maxQueueSize?: number;
+    /**
+     * Maximum number of items drained per poll tick. Defaults to 100.
+     * Prevents a single heartbeat from firing an unbounded burst of on-chain
+     * transactions if the queue fills up.
+     */
+    maxBatchSize?: number;
+};
+export type HttpQueueSource<T> = RelayerSource<T> & {
+    /** Closes the HTTP server. Call after `relayer.stop()` to free the port. */
+    close(): Promise<void>;
+};
+/**
+ * Opens an HTTP server that accepts `POST /submit` requests. Each accepted
+ * item is held in memory until the next `poll()` cycle drains the queue.
+ *
+ * Clients POST JSON matching whatever shape `parse` expects. On success they
+ * receive `{ ok: true, queued: true }` immediately — they don't wait for the
+ * relayer to process the item.
+ *
+ * Security defaults:
+ * - Binds to `127.0.0.1` (loopback only) unless `host` is set.
+ * - Non-loopback binds require `token` to be set; the server throws otherwise.
+ * - Queue is capped at 1000 items (429 when full).
+ * - Each poll drains at most 100 items.
+ * - Request bodies are rejected above 64 KiB.
+ * - `server.headersTimeout` and `server.requestTimeout` are set to 10 s
+ *   to bound slow-loris connections.
+ */
+export declare const httpQueueSource: <T>(options: HttpQueueSourceOptions<T>) => HttpQueueSource<T>;
+//# sourceMappingURL=http-queue.d.ts.map

package/dist/sources/http-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-queue.d.ts","sourceRoot":"","sources":["../../src/sources/http-queue.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAKhD,MAAM,MAAM,sBAAsB,CAAC,CAAC,IAAI;IACtC,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;;;OAGG;IACH,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,CAAC,CAAA;IAC3B;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB,CAAA;AAED,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI,aAAa,CAAC,CAAC,CAAC,GAAG;IAClD,4EAA4E;IAC5E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACvB,CAAA;AA+BD;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,eAAe,GAAI,CAAC,EAAE,SAAS,sBAAsB,CAAC,CAAC,CAAC,KAAG,eAAe,CAAC,CAAC,CAmDxF,CAAA"}

package/dist/sources/http-queue.js

@@ -0,0 +1,97 @@
+import { createServer } from 'node:http';
+/** 64 KiB — generous ceiling for any single RLP payload. */
+const MAX_BODY_BYTES = 65_536;
+const readBody = (req) => new Promise((resolve, reject) => {
+    const contentLength = Number(req.headers['content-length'] ?? 0);
+    if (contentLength > MAX_BODY_BYTES) {
+        req.resume();
+        return reject(new Error('request body too large'));
+    }
+    let size = 0;
+    const chunks = [];
+    req.on('data', (chunk) => {
+        size += chunk.length;
+        if (size > MAX_BODY_BYTES) {
+            req.destroy();
+            return reject(new Error('request body too large'));
+        }
+        chunks.push(chunk);
+    });
+    req.on('end', () => {
+        try {
+            resolve(JSON.parse(Buffer.concat(chunks).toString()));
+        }
+        catch {
+            reject(new Error('invalid JSON'));
+        }
+    });
+    req.on('error', reject);
+});
+const respond = (res, status, body) => {
+    const json = JSON.stringify(body);
+    res.writeHead(status, { 'Content-Type': 'application/json', 'Content-Length': Buffer.byteLength(json) });
+    res.end(json);
+};
+/**
+ * Opens an HTTP server that accepts `POST /submit` requests. Each accepted
+ * item is held in memory until the next `poll()` cycle drains the queue.
+ *
+ * Clients POST JSON matching whatever shape `parse` expects. On success they
+ * receive `{ ok: true, queued: true }` immediately — they don't wait for the
+ * relayer to process the item.
+ *
+ * Security defaults:
+ * - Binds to `127.0.0.1` (loopback only) unless `host` is set.
+ * - Non-loopback binds require `token` to be set; the server throws otherwise.
+ * - Queue is capped at 1000 items (429 when full).
+ * - Each poll drains at most 100 items.
+ * - Request bodies are rejected above 64 KiB.
+ * - `server.headersTimeout` and `server.requestTimeout` are set to 10 s
+ *   to bound slow-loris connections.
+ */
+export const httpQueueSource = (options) => {
+    const host = options.host ?? '127.0.0.1';
+    const maxQueueSize = options.maxQueueSize ?? 1000;
+    const maxBatchSize = options.maxBatchSize ?? 100;
+    const isNonLoopback = host !== '127.0.0.1' && host !== 'localhost' && host !== '::1';
+    if (isNonLoopback && !options.token) {
+        throw new Error(`httpQueueSource: non-loopback bind (${host}) requires a token to be set — ` +
+            `pass token or set host to '127.0.0.1'`);
+    }
+    const queue = [];
+    const server = createServer(async (req, res) => {
+        if (req.method !== 'POST' || req.url !== '/submit') {
+            return respond(res, 404, { ok: false, error: 'not found' });
+        }
+        if (options.token) {
+            const auth = req.headers['authorization'];
+            if (auth !== `Bearer ${options.token}`) {
+                return respond(res, 401, { ok: false, error: 'unauthorized' });
+            }
+        }
+        if (maxQueueSize > 0 && queue.length >= maxQueueSize) {
+            return respond(res, 429, { ok: false, error: 'queue full — try again later' });
+        }
+        try {
+            const body = await readBody(req);
+            const item = options.parse(body);
+            queue.push(item);
+            respond(res, 200, { ok: true, queued: true });
+        }
+        catch (err) {
+            respond(res, 400, { ok: false, error: err instanceof Error ? err.message : 'bad request' });
+        }
+    });
+    // Bound slow-loris connections.
+    server.headersTimeout = 10_000;
+    server.requestTimeout = 10_000;
+    server.listen(options.port ?? 3001, host);
+    return {
+        poll: async () => {
+            const batch = queue.splice(0, maxBatchSize);
+            return batch;
+        },
+        close: () => new Promise((resolve, reject) => server.close((err) => err ? reject(err) : resolve())),
+    };
+};
+//# sourceMappingURL=http-queue.js.map

package/dist/sources/http-queue.js.map

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

package/dist/types.d.ts

@@ -1,21 +1,24 @@
 import type { MsgBoardClient } from '@msgboard/sdk';
-import type { Chain, PublicClient } from 'viem';
+import type { Chain, PublicClient, Transport } from 'viem';
 import type { Logger } from './logger.js';
 /** The two operating modes. `observe` never produces an outbound side effect. */
 export type RelayerMode = 'observe' | 'live';
 /** Identifies the msgboard node a relayer watches. */
 export type RelayerNode = {
-    /** The JSON-RPC URL of the msgboard node. */
-    rpcUrl: string;
-    /** The chain id of the node (1, 369, or 943). */
-    chainId: number;
+    /** viem Transport for the node (e.g. `http('https://...')`). */
+    transport: Transport;
+    /**
+     * viem Chain definition. When omitted, the chain id is detected automatically
+     * via `eth_chainId` on the first tick. Pass explicitly for custom networks.
+     */
+    chain?: Chain;
 };
 /** Everything a source, action, or sink may need at runtime. */
 export type RelayerContext = {
     node: RelayerNode;
     mode: RelayerMode;
     chain: Chain;
-    /** A viem public client over `node.rpcUrl`. */
+    /** A viem public client backed by `node.transport`. */
     publicClient: PublicClient;
     /** A msgboard SDK client wrapping `publicClient`. */
     client: MsgBoardClient;

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AACnD,OAAO,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,MAAM,CAAA;AAC1D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEzC,iFAAiF;AACjF,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,MAAM,CAAA;AAE5C,sDAAsD;AACtD,MAAM,MAAM,WAAW,GAAG;IACxB,gEAAgE;IAChE,SAAS,EAAE,SAAS,CAAA;IACpB;;;OAGG;IACH,KAAK,CAAC,EAAE,KAAK,CAAA;CACd,CAAA;AAED,gEAAgE;AAChE,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,WAAW,CAAA;IACjB,IAAI,EAAE,WAAW,CAAA;IACjB,KAAK,EAAE,KAAK,CAAA;IACZ,uDAAuD;IACvD,YAAY,EAAE,YAAY,CAAA;IAC1B,qDAAqD;IACrD,MAAM,EAAE,cAAc,CAAA;IACtB,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED,oCAAoC;AACpC,MAAM,MAAM,YAAY,GAAG;IACzB,6CAA6C;IAC7C,EAAE,EAAE,OAAO,CAAA;IACX,yEAAyE;IACzE,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,yDAAyD;IACzD,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC/B,CAAA;AAED,wEAAwE;AACxE,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI;IAC7B,IAAI,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,CAAA;CACrD,CAAA;AAED,oFAAoF;AACpF,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI;IAC7B,8EAA8E;IAC9E,QAAQ,CAAC,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,cAAc,GAAG,MAAM,CAAA;IAClD,+DAA+D;IAC/D,OAAO,CAAC,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC,CAAA;CACjE,CAAA;AAED,kFAAkF;AAElF,MAAM,MAAM,YAAY,CAAC,EAAE,IAAI;IAC7B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAClC,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1D,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACxB,CAAA;AAED,6FAA6F;AAC7F,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI;IAC3B,MAAM,CAAC,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACvD,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACxB,CAAA;AAED,8CAA8C;AAC9C,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAA;AAE/C,oEAAoE;AACpE,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,cAAc,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;AAElG,0CAA0C;AAC1C,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI;IAC7B,IAAI,EAAE,WAAW,CAAA;IACjB,+EAA+E;IAC/E,IAAI,CAAC,EAAE,WAAW,CAAA;IAClB,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,CAAA;IACxB,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,CAAA;IACxB,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,CAAA;IAClB,uEAAuE;IACvE,KAAK,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,CAAA;IACvB,4DAA4D;IAC5D,IAAI,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAA;IACrB,SAAS,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAA;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,sEAAsE;IACtE,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB,CAAA;AAED,uFAAuF;AACvF,MAAM,MAAM,UAAU,GAAG;IACvB,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAA;IACd,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAA;IAChB,4DAA4D;IAC5D,QAAQ,EAAE,MAAM,CAAA;IAChB,oDAAoD;IACpD,QAAQ,EAAE,MAAM,CAAA;IAChB,4DAA4D;IAC5D,SAAS,EAAE,MAAM,CAAA;IACjB,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@msgboard/relayer",
-  "version": "0.0.1",
+  "version": "0.0.31",
   "description": "Controllable, safe-by-default pool-watcher relayer for the msgboard board",
   "repository": "github:valve-tech/msgboard",
   "author": "MsgBoard",
@@ -14,13 +14,18 @@
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
+      "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
       "require": "./dist/index.js",
-      "default": "./dist/index.js",
-      "types": "./dist/index.d.ts"
+      "default": "./dist/index.js"
     }
   },
-  "keywords": ["msgboard", "relayer", "pool-watcher", "pulsechain"],
+  "keywords": [
+    "msgboard",
+    "relayer",
+    "pool-watcher",
+    "pulsechain"
+  ],
   "scripts": {
     "prebuild": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\"",
     "build": "tsc",
@@ -29,16 +34,21 @@
     "test:watch": "vitest",
     "lint": "prettier --check ."
   },
-  "files": ["dist/"],
+  "files": [
+    "dist/"
+  ],
   "dependencies": {
-    "@msgboard/sdk": "^0.0.28",
+    "@msgboard/history": "^0.0.31",
+    "@msgboard/sdk": "^0.0.31",
     "viem": "^2.25.0"
   },
   "peerDependencies": {
     "pg": "^8.14.1"
   },
   "peerDependenciesMeta": {
-    "pg": { "optional": true }
+    "pg": {
+      "optional": true
+    }
   },
   "devDependencies": {
     "@types/pg": "^8.11.11",