AnalystClient: post signals and manage reputation

Reference for the @agentbank/sdk AnalystClient — register, deregister, postSignal, getReputation, isRegistered, and getAnalystInfo with TypeScript examples.

AnalystClient wraps the SignalBoardV2 contract. Access it via client.analyst.

Methods

register

Register the connected wallet as an analyst.

const txHash = await client.analyst.register();
// with optional metadata (IPFS CID or arbitrary bytes):
const txHash = await client.analyst.register("0xdeadbeef");

Parameters: metadata?: Hex — optional profile metadata (default "0x")

Returns: Promise<Hash>

---

deregister

Remove the connected wallet from the analyst registry.

const txHash = await client.analyst.deregister();

Returns: Promise<Hash>

---

postSignal

Post a directional trading signal to the SignalBoard.

const txHash = await client.analyst.postSignal({
  asset: "0xdEAddEaDdeadDEadDEADDEAddEADDEAddead1111",
  direction: 1,       // -1 = short, 0 = neutral, 1 = long
  magnitude: 750,     // 750 bps = 7.5% confidence
  reasoning: "RSI divergence on 4H timeframe — bullish",
  ttl: 7200,          // 2 hours in seconds
});

Parameters (SignalParams):

Field	Type	Description
asset	Address	Target token address
direction	-1 | 0 | 1	Short / neutral / long
magnitude	number	Signal strength in bps (0–10,000)
reasoning	string | Hex	Reasoning text (auto-hashed) or pre-hashed 32-byte hex
ttl	number	Signal lifetime in seconds

Returns: Promise<Hash>

---

getReputation

Fetch on-chain reputation for an analyst address.

const rep = await client.analyst.getReputation("0x...");
// rep.score            bigint
// rep.totalSignals     bigint
// rep.profitableSignals bigint
// rep.avgPnlBps        bigint

Returns: Promise<ReputationData>

---

isRegistered

Check whether an address is a registered analyst.

const ok = await client.analyst.isRegistered("0x...");

Returns: Promise<boolean>

---

getAnalystInfo

Get full analyst struct from the SignalBoard.

const info = await client.analyst.getAnalystInfo("0x...");
// info.registered    boolean
// info.stakedAmount  bigint
// info.reputation    bigint
// info.registeredAt  bigint

Returns: Promise<AnalystInfo>