Message Submission

eth_sendMessageBlob

Submit a message to the network.

Parameters

{
  "from": "0x...", // Sender address (20 bytes)
  "data": "0x...", // Payload (max 8 KB)
  "signature": "0x...", // ECDSA signature (65 bytes)
  "nonce": "0x...", // Unique nonce (prevents replay)
  "chainId": "0x1a5", // Chain ID (421)
  "bid": "0x...", // Optional: PMQ bid in wei (≥0.001 OBS)
  "vdfProof": "0x...", // Required for SMQ: VDF proof
  "vdfIterations": "0x...", // Required for SMQ: iterations used
  "vdfAlgVersion": "0x1" // VDF algorithm version
}

Response

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x..." // Message hash
}

Example: Priority Message

await provider.send("eth_sendMessageBlob", [
  {
    from: address,
    data: payload,
    signature: sig,
    nonce: "0x" + Date.now().toString(16),
    chainId: "0x1a5",
    bid: "0x" + ethers.parseEther("0.01").toString(16),
  },
]);

Example: Free Message (SMQ)

// Get VDF work requirement
const work = await provider.send("eth_getMessageWork", [{ payloadSize: "0x100" }]);

// Compute VDF proof
const proof = computeVDF(challenge, work.requiredIterations);

// Submit
await provider.send("eth_sendMessageBlob", [
  {
    from: address,
    data: payload,
    signature: sig,
    nonce: nonceHex,
    chainId: "0x1a5",
    vdfProof: proof,
    vdfIterations: work.requiredIterations,
    vdfAlgVersion: "0x1",
  },
]);

Errors

Code	Message
-32000	Invalid signature
-32001	Payload too large
-32002	Invalid VDF proof
-32003	Bid too low for PMQ
-32004	Queue full
-32005	Duplicate nonce

eth_getMessageWork

Get VDF parameters for free messages.

Parameters

{
  "payloadSize": "0x..." // Size of payload in bytes (hex)
}

Response

{
  "requiredIterations": "0x2710",
  "algVersion": "0x1"
}