下载
| 文件 | 内容 |
|---|---|
| input_settler_escrow.json | 托管输入结算器 IDL |
| output_settler_simple.json | 输出结算器 IDL |
| polymer.json | Polymer 预言机 IDL |
| intents_protocol.json | 认证与链配置 IDL |
| wormhole.json | Wormhole 预言机 IDL——源码接口参考，其内嵌地址与已公布的主网部署不同 |
| errors.json | 所有第一方错误目录，以及每个程序可能返回哪些目录 |
| provenance.json | 源代码版本、源代码与原始 IDL 指纹、所应用的修正，以及各产物的哈希 |
anchor build 得到的是未经本页所述修正的原始 IDL。
需要自行派生的账户
程序中有十处 PDA 表达式会对指令参数做哈希或调用方法，而 Anchor 的自动账户解析器无法执行它们。已发布的 IDL 去掉了这些pda 提示，因此 Anchor 不会自动填入这些账户。请在客户端派生它们并显式传入：
| 程序 | 指令 | 账户 | PDA 种子（按顺序） |
|---|---|---|---|
input_settler_escrow | open、finalise、refund、refund_on_non_fill | order_context | UTF-8 order_context、规范订单 ID |
input_settler_escrow | open | consumed_order | UTF-8 consumed_order、规范订单 ID |
output_settler_simple | attest_not_filled | fill_id | 规范订单 ID、规范输出哈希 |
output_settler_simple | fill、native_fill、fill_samechain、native_fill_samechain | fill_record | 规范订单 ID、规范输出哈希 |
fill_id 和 fill_record 是同一个地址的两个名字。
规范订单 ID
使用哪个值取决于订单源自哪里：- 输入结算器指令（
open、finalise、refund、refund_on_non_fill）以及紧凑同链填充（fill_samechain、native_fill_samechain）使用keccak256(Borsh(StandardOrder))——对输入结算器是已签名的订单，对紧凑路径是完全展开后的订单。永远不要用 JSON、紧凑订单字节或 SHA-256 摘要的哈希来代替。 - 普通输出填充（
fill、native_fill、attest_not_filled）将order_id作为参数接收，且不会验证它。请逐字节传入源链的订单标识符，与该链输入结算器计算出的完全一致。只有在 Solana 托管上开启的订单，该值才是上面的 Borsh 哈希；对于源自 EVM 或其他链的订单，请使用该链自己的订单 ID。以其他任何值记录的填充都无法为该订单结算。
规范输出哈希
输出哈希是对以下紧凑打包编码计算的 keccak-256——而不是MandateOutput 的 Borsh 编码：
oracle[32] || settler[32] || chain_id[32] || token[32] || amount[32]
|| recipient[32] || callback_length[u16 big-endian] || callback_data
|| context_length[u16 big-endian] || context
chain_id 和 amount 取其 32 字节大端序值，每个变长字段都必须能放进一个 u16。
对于紧凑同链填充，请先像程序那样展开输出：oracle 和 settler 为输出结算器的状态 PDA，chain_id 来自该状态，token 为铸币（原生 SOL 为 32 字节的零），amount 为 output_amount，recipient 为接收方账户，callback_data 为空。context 在 None 时为空，否则为 0xe0 || exclusive_for[32] || start_time[u32 big-endian]——ExclusiveForSelf 使用填充者的公钥作为 exclusive_for。
示例：派生托管账户
import { Program, type AnchorProvider } from "@coral-xyz/anchor";
import { PublicKey } from "@solana/web3.js";
import { keccak_256 } from "@noble/hashes/sha3.js";
import inputIdl from "./input_settler_escrow.json";
import type { InputSettlerEscrow } from "./types/input_settler_escrow";
// provider and order are supplied by your application. Bytes fields use Buffers;
// wide integer fields use BN, as required by the Anchor coder.
const program = new Program<InputSettlerEscrow>(
inputIdl as unknown as InputSettlerEscrow,
provider
);
const orderId = Buffer.from(
keccak_256(program.coder.types.encode("standardOrder", order))
);
const [orderContext] = PublicKey.findProgramAddressSync(
[Buffer.from("order_context"), orderId],
program.programId
);
const [consumedOrder] = PublicKey.findProgramAddressSync(
[Buffer.from("consumed_order"), orderId],
program.programId
);
const instruction = await program.methods
.open(order)
.accountsStrict({
...allOtherOpenAccounts,
orderContext,
consumedOrder,
})
.instruction();
allOtherOpenAccounts 必须包含 open 的其他所有具名账户，因为 accountsStrict 会关闭整条指令的自动解析。请使用 TypeScript 类型中的驼峰式账户名和参数名。构建指令并不会检查余额、所有权、哈希或链上状态。请启用 TypeScript 的 strict（至少 strictNullChecks），以便 Anchor 的账户类型能区分必需账户和可选账户。
紧凑同链填充
fill_samechain 和 native_fill_samechain 必须在同一笔交易中、紧跟在一个匹配的 finalise_with_prefill 之后执行。它们不会创建 LocalAttestation。永远不要单独提交它们，也不要用它们代替普通填充。finalise_with_prefill(order_id) → fill_samechain(args)
or
finalise_with_prefill(order_id) → native_fill_samechain(args)
finalise_with_prefill 会向后查找匹配的紧凑填充，并在释放托管资金之前，将传入的订单 ID 与展开后的订单绑定。紧凑填充的处理逻辑自身不会检查前面是否有结算指令，因此单独的紧凑填充会支付输出，却让求解器没有任何可据以领取的东西。完整工作流见先释放输入的 Solana 结算。
Remaining accounts
这些账户通过.remainingAccounts(...) 追加在具名账户之后；它们的数量取决于订单，因此不是固定的 IDL 账户。下文中，N 为输出或载荷数量，A 为认证，R 为其存储的租金退还接收方。所有 remaining account 条目都不是签名者。
| 指令 | 所需顺序 | 权限与签名 |
|---|---|---|
托管 finalise | 恰好为 [A0, …, A(N−1), R0, …, R(N−1)] | 对于以托管程序为消费方的本地认证，A 和 R 均可写。具名的求解器签名，且须与第一个输出的求解器一致。 |
托管 refund_on_non_fill | 对所选输出恰好为 [A, R] | 当托管程序是消费方时两者均可写。具名签名者签名；退款仍无需许可。 |
Polymer submit | 恰好为 [A0, …, A(N−1)] | 只读；无退还槽位，也无指令签名者。N 必须为正数。 |
Polymer submit_consume | 恰好为 [A0, R0, …, A(N−1), R(N−1)] | 全部可写。N 必须为正数。具名的 submitter 签名，且必须是每个填充载荷中记录的填充者；未填充载荷无需许可。 |
Wormhole submit | 恰好为 [A0, R0, …, A(N−1), R(N−1)] | 全部可写。N 必须为正数。具名的 submitter 和一个全新的 post-message 账户签名；没有填充者签名的要求。 |
Wormhole receive | 恰好为 [A0, …, A(N−1)]，按解码出的 VAA 载荷顺序 | 可写的目标认证 PDA。具名签名者为其创建付费。无退还槽位。 |
submit_consume：
const remaining = [attestation0, refund0, attestation1, refund1].map(
(pubkey) => ({ pubkey, isWritable: true, isSigner: false })
);
// Append with builder.remainingAccounts(remaining).
// A one-output finalise instead uses [attestation0, refund0].
事件与错误
每个 IDL 都列出了其程序发出的事件。Wormhole IDL 包含由共享预言机代码发出的OutputProvenEvent；它的鉴别器和字段顺序与 Polymer 一致：先是 u128 类型的链 ID，然后是三个 32 字节字段（远程标识符、application、载荷哈希）。
每个程序 IDL 只列出其本地错误。共享错误——以及它所调用的程序的错误——位于 errors.json 中，按枚举名组织，每项包含 Rust 源路径、数字错误码、名称和消息。其 programs 映射按程序 ID 列出本地目录，以及该程序可能返回的共享或 CPI 目录。
| 目录 | 错误码 | 返回方 |
|---|---|---|
CommonErrors | 6000–6022 | 托管、输出结算器、预言机 |
IntentsProtocolErrors | 6100–6110 | intents_protocol，以及所有调用它的程序 |
InputSettlerBaseErrors | 6200–6201 | 托管 |
InputSettlerEscrowErrors | 6300–6311 | 托管（本地） |
OutputSettlerBaseErrors | 6400–6405 | 输出结算器 |
OutputSettlerSimpleErrors | 6500–6509 | 输出结算器（本地） |
OracleBaseErrors | 6600–6602 | Polymer、Wormhole |
OraclePolymerErrors | 6700–6722 | Polymer（本地） |
OracleWormholeErrors | 6800–6803 | Wormhole（本地） |
intents_protocol 的 CPI 中发生的失败使用其目录。即使数字重叠，也永远不要用这些错误码去标注未知或外部程序的错误；Anchor 框架错误和外部 CPI 错误需要各自的解码器。某个目录与某个程序相关联，并不意味着每个变体都能从每条指令触发。Anchor 默认的错误解码器不会读取 errors.json——请自行加载它。你最可能遇到的错误列在在 Solana 上调试中。
来源
该包描述的是 Solana 程序代码仓库776773a 提交下的五个生产程序，使用 Anchor 0.31.1 构建。provenance.json 记录了完整的提交、源代码与原始 IDL 指纹、所应用的每一项修正，以及每个已发布文件的哈希。这些修正只改变客户端元数据——移除 pda 提示并补充 Wormhole 事件——从不改变账户、标志、参数或链上约束。已发布的审计报告覆盖的是经过审查的合约版本；IDL 工具链是之后的集成改动。
TypeScript 类型
与每个 IDL 对应的驼峰式 TypeScript 类型，供 Anchor 的Program<T> 使用。请把每个类型保存为 JSON 文件旁边的 types/<program>.ts。每个类型都精确描述对应的 JSON IDL；如果你自行重新生成 IDL，请从同一次构建中重新生成类型。
types/input_settler_escrow.ts
types/input_settler_escrow.ts
input_settler_escrow.ts
/** Generated by yarn idl:generate. Runtime IDL: ../input_settler_escrow.json. */
export type InputSettlerEscrow = {
"address": "LiFiRp8RM7nJUZyUYC9FPPpDr7sAy5XPfBN6ABzBgT7",
"metadata": {
"name": "inputSettlerEscrow",
"version": "0.0.0",
"spec": "0.1.0"
},
"instructions": [
{
"name": "finalise",
"docs": [
"Finalise a filled order and send the order's input funds to the order's solver.",
"`order` is the open order to be finalised.",
"`solve_params` are the solver parameters that filled each output (one per output). The first solver must be",
"the signer.",
"Remaining accounts: exactly 2*N accounts, where N is order.outputs.length: [attestation_0, ..., attestation_N-1, rent_refund_0, ..., rent_refund_N-1], in output order.",
"For local attestations committed to this input settler program, both the attestation and its stored rent-refund recipient must be writable. Executable recipients defer reclamation; keep both writable.",
"For remote or foreign-consumer attestations, the refund slot is required but ignored; those slots and attestations can be read-only. Remaining accounts require no additional signers. The named solver must sign and match the first output's solver."
],
"discriminator": [
197,
63,
114,
249,
245,
72,
39,
132
],
"accounts": [
{
"name": "solver",
"writable": true,
"signer": true
},
{
"name": "inputSettlerEscrow",
"pda": {
"seeds": [
{
"kind": "const",
"value": [
105,
110,
112,
117,
116,
95,
115,
101,
116,
116,
108,
101,
114,
95,
101,
115,
99,
114,
111,
119
]
}
]
}
},
{
"name": "user"
},
{
"name": "sponsor",
"docs": [
"via the `has_one = sponsor` constraint on `order_context`.",
"Receives both rent refunds unless executable, in which case they go to `solver`."
],
"writable": true,
"relations": [
"orderContext"
]
},
{
"name": "destination"
},
{
"name": "destinationTokenAccount",
"writable": true,
"pda": {
"seeds": [
{
"kind": "account",
"path": "destination"
},
{
"kind": "account",
"path": "tokenProgram"
},
{
"kind": "account",
"path": "mint"
}
],
"program": {
"kind": "const",
"value": [
140,
151,
37,
143,
78,
36,
137,
241,
187,
61,
16,
41,
20,
142,
13,
131,
11,
90,
19,
153,
218,
255,
16,
132,
4,
142,
123,
216,
219,
233,
248,
89
]
}
}
},
{
"name": "orderContext",
"writable": true,
"docs": [
"Supply this PDA explicitly. Anchor cannot represent the existing hashed seed expression. Use the canonical order/output hash and original program seeds; see this bundle's README.md. Runtime constraints are unchanged."
]
},
{
"name": "orderPdaTokenAccount",
"writable": true,
"pda": {
"seeds": [
{
"kind": "account",
"path": "orderContext"
},
{
"kind": "account",
"path": "tokenProgram"
},
{
"kind": "account",
"path": "mint"
}
],
"program": {
"kind": "const",
"value": [
140,
151,
37,
143,
78,
36,
137,
241,
187,
61,
16,
41,
20,
142,
13,
131,
11,
90,
19,
153,
218,
255,
16,
132,
4,
142,
123,
216,
219,
233,
248,
89
]
}
}
},
{
"name": "mint",
"writable": true
},
{
"name": "localConsumer",
"docs": [
"no data). It signs the consumption of local attestations whose",
"committed consumer is this PROGRAM ID."
],
"pda": {
"seeds": [
{
"kind": "const",
"value": [
108,
111,
99,
97,
108,
95,
99,
111,
110,
115,
117,
109,
101,
114
]
}
]
}
},
{
"name": "intentsProtocolProgram",
"address": "LiFixdGLT5CMdLsHBvaijTXpPy4Uux9Y53SXkuR4HaK"
},
{
"name": "tokenProgram"
},
{
"name": "associatedTokenProgram",
"address": "ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL"
},
{
"name": "systemProgram",
"address": "11111111111111111111111111111111"
}
],
"args": [
{
"name": "order",
"type": {
"defined": {
"name": "standardOrder"
}
}
},
{
"name": "solveParams",
"type": {
"vec": {
"defined": {
"name": "solveParams"
}
}
}
}
]
},
{
"name": "finaliseWithPrefill",
"docs": [
"Atomically release an open order's input before its compact same-chain fill executes.",
"The exact later fill is pinned through the Instructions sysvar."
],
"discriminator": [
168,
65,
122,
15,
125,
60,
136,
108
],
"accounts": [
{
"name": "solver",
"writable": true,
"signer": true
},
{
"name": "inputSettlerEscrow",
"pda": {
"seeds": [
{
"kind": "const",
"value": [
105,
110,
112,
117,
116,
95,
115,
101,
116,
116,
108,
101,
114,
95,
101,
115,
99,
114,
111,
119
]
}
]
}
},
{
"name": "user"
},
{
"name": "sponsor",
"docs": [
"executable, in which case they go to `solver`."
],
"writable": true,
"relations": [
"orderContext"
]
},
{
"name": "destination"
},
{
"name": "destinationTokenAccount",
"writable": true,
"pda": {
"seeds": [
{
"kind": "account",
"path": "destination"
},
{
"kind": "account",
"path": "tokenProgram"
},
{
"kind": "account",
"path": "mint"
}
],
"program": {
"kind": "const",
"value": [
140,
151,
37,
143,
78,
36,
137,
241,
187,
61,
16,
41,
20,
142,
13,
131,
11,
90,
19,
153,
218,
255,
16,
132,
4,
142,
123,
216,
219,
233,
248,
89
]
}
}
},
{
"name": "orderContext",
"writable": true,
"pda": {
"seeds": [
{
"kind": "const",
"value": [
111,
114,
100,
101,
114,
95,
99,
111,
110,
116,
101,
120,
116
]
},
{
"kind": "arg",
"path": "orderId"
}
]
}
},
{
"name": "orderPdaTokenAccount",
"writable": true,
"pda": {
"seeds": [
{
"kind": "account",
"path": "orderContext"
},
{
"kind": "account",
"path": "tokenProgram"
},
{
"kind": "account",
"path": "mint"
}
],
"program": {
"kind": "const",
"value": [
140,
151,
37,
143,
78,
36,
137,
241,
187,
61,
16,
41,
20,
142,
13,
131,
11,
90,
19,
153,
218,
255,
16,
132,
4,
142,
123,
216,
219,
233,
248,
89
]
}
}
},
{
"name": "mint",
"writable": true
},
{
"name": "instructionsSysvar",
"address": "Sysvar1nstructions1111111111111111111111111"
},
{
"name": "tokenProgram"
},
{
"name": "associatedTokenProgram",
"address": "ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL"
},
{
"name": "systemProgram",
"address": "11111111111111111111111111111111"
}
],
"args": [
{
"name": "orderId",
"type": {
"array": [
"u8",
32
]
}
}
]
},
{
"name": "initialize",
"docs": [
"Creates `input settler escrow` PDA.",
"`input settler escrow` PDA is used to store the chain identifier."
],
"discriminator": [
175,
175,
109,
31,
13,
152,
155,
237
],
"accounts": [
{
"name": "deployer",
"writable": true,
"signer": true
},
{
"name": "chainId"
},
{
"name": "inputSettlerEscrow",
"writable": true,
"pda": {
"seeds": [
{
"kind": "const",
"value": [
105,
110,
112,
117,
116,
95,
115,
101,
116,
116,
108,
101,
114,
95,
101,
115,
99,
114,
111,
119
]
}
]
}
},
{
"name": "intentsProtocolProgram",
"address": "LiFixdGLT5CMdLsHBvaijTXpPy4Uux9Y53SXkuR4HaK"
},
{
"name": "systemProgram",
"address": "11111111111111111111111111111111"
}
],
"args": []
},
{
"name": "open",
"docs": [
"Open the given `StandardOrder`. The order input funds will be pulled from the provided",
"user signer account, and will be escrowed until the order is finalised or expired."
],
"discriminator": [
228,
220,
155,
71,
199,
189,
60,
45
],
"accounts": [
{
"name": "sponsor",
"writable": true,
"signer": true
},
{
"name": "user",
"signer": true
},
{
"name": "inputSettlerEscrow",
"pda": {
"seeds": [
{
"kind": "const",
"value": [
105,
110,
112,
117,
116,
95,
115,
101,
116,
116,
108,
101,
114,
95,
101,
115,
99,
114,
111,
119
]
}
]
}
},
{
"name": "userTokenAccount",
"writable": true,
"pda": {
"seeds": [
{
"kind": "account",
"path": "user"
},
{
"kind": "account",
"path": "tokenProgram"
},
{
"kind": "account",
"path": "mint"
}
],
"program": {
"kind": "const",
"value": [
140,
151,
37,
143,
78,
36,
137,
241,
187,
61,
16,
41,
20,
142,
13,
131,
11,
90,
19,
153,
218,
255,
16,
132,
4,
142,
123,
216,
219,
233,
248,
89
]
}
}
},
{
"name": "orderContext",
"writable": true,
"docs": [
"Supply this PDA explicitly. Anchor cannot represent the existing hashed seed expression. Use the canonical order/output hash and original program seeds; see this bundle's README.md. Runtime constraints are unchanged."
]
},
{
"name": "consumedOrder",
"writable": true,
"docs": [
"Supply this PDA explicitly. Anchor cannot represent the existing hashed seed expression. Use the canonical order/output hash and original program seeds; see this bundle's README.md. Runtime constraints are unchanged."
]
},
{
"name": "orderPdaTokenAccount",
"writable": true,
"pda": {
"seeds": [
{
"kind": "account",
"path": "orderContext"
},
{
"kind": "account",
"path": "tokenProgram"
},
{
"kind": "account",
"path": "mint"
}
],
"program": {
"kind": "const",
"value": [
140,
151,
37,
143,
78,
36,
137,
241,
187,
61,
16,
41,
20,
142,
13,
131,
11,
90,
19,
153,
218,
255,
16,
132,
4,
142,
123,
216,
219,
233,
248,
89
]
}
}
},
{
"name": "mint"
},
{
"name": "tokenProgram"
},
{
"name": "associatedTokenProgram",
"address": "ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL"
},
{
"name": "systemProgram",
"address": "11111111111111111111111111111111"
}
],
"args": [
{
"name": "order",
"type": {
"defined": {
"name": "standardOrder"
}
}
}
]
},
{
"name": "refund",
"docs": [
"Refund an order and send the order's input funds back to the user."
],
"discriminator": [
2,
96,
183,
251,
63,
208,
46,
46
],
"accounts": [
{
"name": "signer",
"writable": true,
"signer": true
},
{
"name": "user"
},
{
"name": "sponsor",
"docs": [
"via the `has_one = sponsor` constraint on `order_context`.",
"Receives both rent refunds unless executable, in which case they go to `signer`."
],
"writable": true,
"relations": [
"orderContext"
]
},
{
"name": "inputSettlerEscrow",
"pda": {
"seeds": [
{
"kind": "const",
"value": [
105,
110,
112,
117,
116,
95,
115,
101,
116,
116,
108,
101,
114,
95,
101,
115,
99,
114,
111,
119
]
}
]
}
},
{
"name": "orderContext",
"writable": true,
"docs": [
"Supply this PDA explicitly. Anchor cannot represent the existing hashed seed expression. Use the canonical order/output hash and original program seeds; see this bundle's README.md. Runtime constraints are unchanged."
]
},
{
"name": "orderPdaTokenAccount",
"writable": true,
"pda": {
"seeds": [
{
"kind": "account",
"path": "orderContext"
},
{
"kind": "account",
"path": "tokenProgram"
},
{
"kind": "account",
"path": "mint"
}
],
"program": {
"kind": "const",
"value": [
140,
151,
37,
143,
78,
36,
137,
241,
187,
61,
16,
41,
20,
142,
13,
131,
11,
90,
19,
153,
218,
255,
16,
132,
4,
142,
123,
216,
219,
233,
248,
89
]
}
}
},
{
"name": "userTokenAccount",
"writable": true,
"pda": {
"seeds": [
{
"kind": "account",
"path": "user"
},
{
"kind": "account",
"path": "tokenProgram"
},
{
"kind": "account",
"path": "mint"
}
],
"program": {
"kind": "const",
"value": [
140,
151,
37,
143,
78,
36,
137,
241,
187,
61,
16,
41,
20,
142,
13,
131,
11,
90,
19,
153,
218,
255,
16,
132,
4,
142,
123,
216,
219,
233,
248,
89
]
}
}
},
{
"name": "mint",
"writable": true
},
{
"name": "tokenProgram"
},
{
"name": "associatedTokenProgram",
"address": "ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL"
},
{
"name": "systemProgram",
"address": "11111111111111111111111111111111"
}
],
"args": [
{
"name": "order",
"type": {
"defined": {
"name": "standardOrder"
}
}
}
]
},
{
"name": "refundOnNonFill",
"docs": [
"Refund an order as soon as one of its outputs is proven not filled before the fill deadline,",
"sending the order's input funds back to the user. Does not require `expires` to have passed.",
"`order` is the open order to be refunded.",
"`output_index` is the index of the output proven not filled.",
"Remaining accounts: exactly [attestation, rent_refund] for order.outputs[output_index].",
"For a local attestation committed to this input settler program, both accounts must be writable and rent_refund must be the stored recipient; executable recipients defer reclamation. Otherwise the refund slot is required but ignored and both accounts can be read-only.",
"Remaining accounts require no additional signers. The named signer must sign; the refund remains permissionless and goes to the order user."
],
"discriminator": [
53,
164,
197,
243,
243,
43,
185,
108
],
"accounts": [
{
"name": "signer",
"writable": true,
"signer": true
},
{
"name": "user"
},
{
"name": "sponsor",
"docs": [
"via the `has_one = sponsor` constraint on `order_context`.",
"Receives both rent refunds unless executable, in which case they go to `signer`."
],
"writable": true,
"relations": [
"orderContext"
]
},
{
"name": "inputSettlerEscrow",
"pda": {
"seeds": [
{
"kind": "const",
"value": [
105,
110,
112,
117,
116,
95,
115,
101,
116,
116,
108,
101,
114,
95,
101,
115,
99,
114,
111,
119
]
}
]
}
},
{
"name": "orderContext",
"writable": true,
"docs": [
"Supply this PDA explicitly. Anchor cannot represent the existing hashed seed expression. Use the canonical order/output hash and original program seeds; see this bundle's README.md. Runtime constraints are unchanged."
]
},
{
"name": "orderPdaTokenAccount",
"writable": true,
"pda": {
"seeds": [
{
"kind": "account",
"path": "orderContext"
},
{
"kind": "account",
"path": "tokenProgram"
},
{
"kind": "account",
"path": "mint"
}
],
"program": {
"kind": "const",
"value": [
140,
151,
37,
143,
78,
36,
137,
241,
187,
61,
16,
41,
20,
142,
13,
131,
11,
90,
19,
153,
218,
255,
16,
132,
4,
142,
123,
216,
219,
233,
248,
89
]
}
}
},
{
"name": "userTokenAccount",
"writable": true,
"pda": {
"seeds": [
{
"kind": "account",
"path": "user"
},
{
"kind": "account",
"path": "tokenProgram"
},
{
"kind": "account",
"path": "mint"
}
],
"program": {
"kind": "const",
"value": [
140,
151,
37,
143,
78,
36,
137,
241,
187,
61,
16,
41,
20,
142,
13,
131,
11,
90,
19,
153,
218,
255,
16,
132,
4,
142,
123,
216,
219,
233,
248,
89
]
}
}
},
{
"name": "mint",
"writable": true
},
{
"name": "localConsumer",
"docs": [
"no data). It signs the consumption of local attestations whose",
"committed consumer is this PROGRAM ID."
],
"pda": {
"seeds": [
{
"kind": "const",
"value": [
108,
111,
99,
97,
108,
95,
99,
111,
110,
115,
117,
109,
101,
114
]
}
]
}
},
{
"name": "intentsProtocolProgram",
"address": "LiFixdGLT5CMdLsHBvaijTXpPy4Uux9Y53SXkuR4HaK"
},
{
"name": "tokenProgram"
},
{
"name": "associatedTokenProgram",
"address": "ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL"
},
{
"name": "systemProgram",
"address": "11111111111111111111111111111111"
}
],
"args": [
{
"name": "order",
"type": {
"defined": {
"name": "standardOrder"
}
}
},
{
"name": "outputIndex",
"type": "u8"
}
]
}
],
"accounts": [
{
"name": "chainId",
"discriminator": [
203,
146,
201,
161,
230,
71,
157,
218
]
},
{
"name": "consumedOrder",
"discriminator": [
149,
74,
117,
35,
63,
65,
71,
140
]
},
{
"name": "inputSettlerEscrowAccount",
"discriminator": [
85,
112,
162,
215,
22,
13,
16,
72
]
},
{
"name": "orderContext",
"discriminator": [
240,
83,
159,
216,
26,
11,
225,
229
]
}
],
"events": [
{
"name": "finalisedEvent",
"discriminator": [
226,
131,
196,
252,
105,
222,
23,
210
]
},
{
"name": "openEvent",
"discriminator": [
13,
191,
79,
145,
65,
183,
42,
90
]
},
{
"name": "refundedEvent",
"discriminator": [
220,
3,
153,
244,
133,
189,
73,
119
]
}
],
"errors": [
{
"code": 6300,
"name": "solversLengthMismatch",
"msg": "Solvers length mismatch."
},
{
"code": 6301,
"name": "firstSolverNotInSolvers",
"msg": "First solver not in solvers."
},
{
"code": 6302,
"name": "finaliseTxTooLarge",
"msg": "Finalise transaction would exceed Solana's max packet size."
},
{
"code": 6303,
"name": "outputIndexOutOfBounds",
"msg": "Output index is out of bounds."
},
{
"code": 6304,
"name": "wrongAttestationCount",
"msg": "Exactly one attestation account is required."
},
{
"code": 6305,
"name": "notTopLevel",
"msg": "Input-first finalisation must be invoked as a top-level instruction."
},
{
"code": 6306,
"name": "missingSamechainFillInstruction",
"msg": "A matching future compact same-chain fill instruction is required."
},
{
"code": 6307,
"name": "ambiguousSamechainFillInstruction",
"msg": "More than one matching compact same-chain fill instruction was found."
},
{
"code": 6308,
"name": "invalidSamechainFillInstruction",
"msg": "The compact same-chain fill instruction is malformed or has invalid accounts."
},
{
"code": 6309,
"name": "invalidSamechainOrder",
"msg": "The compact same-chain order does not hash to the supplied order id."
},
{
"code": 6310,
"name": "invalidSamechainOrderContext",
"msg": "The order context does not match the compact same-chain order."
},
{
"code": 6311,
"name": "executableRentRefundAccount",
"msg": "The selected rent refund recipient must not be executable."
}
],
"types": [
{
"name": "chainId",
"docs": [
"Type used to store the chain id of the chain."
],
"type": {
"kind": "struct",
"fields": [
{
"name": "chainId",
"type": "u128"
},
{
"name": "bump",
"type": "u8"
}
]
}
},
{
"name": "consumedOrder",
"docs": [
"This account should be used to track if an order has already been opened by a user.",
"It should be unique to each order for each user.",
"This means a user should not be allowed to open the same order twice.",
"This account should always live on chain and not be closed."
],
"type": {
"kind": "struct",
"fields": []
}
},
{
"name": "finalisedEvent",
"docs": [
"Emitted by both `finalise` and `finalise_with_prefill`, mirroring the EVM",
"`Finalised(orderId, solver, destination)` event. Settled amounts are intentionally not",
"emitted."
],
"type": {
"kind": "struct",
"fields": [
{
"name": "settler",
"type": "pubkey"
},
{
"name": "orderId",
"type": {
"array": [
"u8",
32
]
}
},
{
"name": "solver",
"type": {
"array": [
"u8",
32
]
}
},
{
"name": "destination",
"type": {
"array": [
"u8",
32
]
}
}
]
}
},
{
"name": "inputSettlerEscrowAccount",
"docs": [
"Represents the input settler implementation type.",
"Implements the `InputSettlerBaseTrait` trait."
],
"type": {
"kind": "struct",
"fields": [
{
"name": "chainId",
"type": "u128"
},
{
"name": "bump",
"type": "u8"
}
]
}
},
{
"name": "mandateInput",
"type": {
"kind": "struct",
"fields": [
{
"name": "token",
"type": "pubkey"
},
{
"name": "amount",
"type": "u64"
}
]
}
},
{
"name": "mandateOutput",
"docs": [
"Defines the output state and where and how it should be filled.",
"DEV NOTES:",
"`oracle`: the implementation responsible for collecting the proof from settler on output chain",
"`settler`: the implementation on the output chain responsible for settling the output payment.",
"`callback_data`: the data to be passed to the callback function. MUST be empty if no callback is needed.",
"`context`: The output context for the output settlement, encoding order types or other information."
],
"type": {
"kind": "struct",
"fields": [
{
"name": "oracle",
"type": {
"array": [
"u8",
32
]
}
},
{
"name": "settler",
"type": {
"array": [
"u8",
32
]
}
},
{
"name": "chainId",
"type": {
"array": [
"u8",
32
]
}
},
{
"name": "token",
"type": {
"array": [
"u8",
32
]
}
},
{
"name": "amount",
"type": {
"array": [
"u8",
32
]
}
},
{
"name": "recipient",
"type": {
"array": [
"u8",
32
]
}
},
{
"name": "callbackData",
"type": "bytes"
},
{
"name": "context",
"type": "bytes"
}
]
}
},
{
"name": "openEvent",
"docs": [
"Events must be defined directly in the program crate: Anchor's IDL",
"generator only collects `#[event]` structs from the crate that owns the",
"`#[program]` module."
],
"type": {
"kind": "struct",
"fields": [
{
"name": "orderId",
"type": {
"array": [
"u8",
32
]
}
},
{
"name": "order",
"type": {
"defined": {
"name": "standardOrder"
}
}
}
]
}
},
{
"name": "orderContext",
"docs": [
"The context to opened as an account after opening an order.",
"`input_token` is the token account of the input \"Mint\".",
"`user` is the user who opened the order.",
"`sponsor` is the account that paid for the tx and the rent for this account.",
"Both escrow rent refunds go here on settlement unless it is executable, in which case",
"they go to the solver (finalisation) or signer (refund).",
"It can be the user itself or a third party that paid on the user's behalf.",
"`bump` is the bump of this account to be reused during finalisation."
],
"type": {
"kind": "struct",
"fields": [
{
"name": "inputToken",
"type": "pubkey"
},
{
"name": "user",
"type": "pubkey"
},
{
"name": "sponsor",
"type": "pubkey"
},
{
"name": "bump",
"type": "u8"
}
]
}
},
{
"name": "refundedEvent",
"type": {
"kind": "struct",
"fields": [
{
"name": "orderId",
"type": {
"array": [
"u8",
32
]
}
}
]
}
},
{
"name": "solveParams",
"type": {
"kind": "struct",
"fields": [
{
"name": "solver",
"type": {
"array": [
"u8",
32
]
}
},
{
"name": "timestamp",
"type": "u32"
}
]
}
},
{
"name": "standardOrder",
"docs": [
"Defines the standard order structure.",
"DEV NOTES:",
"`expires`: the timestamp the order should be filled before. IMPORTANT for solvers to check.",
"`fill_deadline`: the timestamp for the funds to be reached to `user` on the output chain. IMPORTANT for solvers to check.",
"`input_oracle`: the oracle responsible for collecting the proof from the output chain."
],
"type": {
"kind": "struct",
"fields": [
{
"name": "user",
"type": "pubkey"
},
{
"name": "nonce",
"type": "u128"
},
{
"name": "originChainId",
"type": "u128"
},
{
"name": "expires",
"type": "u32"
},
{
"name": "fillDeadline",
"type": "u32"
},
{
"name": "inputOracle",
"type": "pubkey"
},
{
"name": "input",
"type": {
"defined": {
"name": "mandateInput"
}
}
},
{
"name": "outputs",
"type": {
"vec": {
"defined": {
"name": "mandateOutput"
}
}
}
}
]
}
}
]
};
types/output_settler_simple.ts
types/output_settler_simple.ts
output_settler_simple.ts
/** Generated by yarn idl:generate. Runtime IDL: ../output_settler_simple.json. */
export type OutputSettlerSimple = {
"address": "LiFiEDFjz5x1jJe9gSXNDHQW4dWt4yLXdp2VN4EiQUt",
"metadata": {
"name": "outputSettlerSimple",
"version": "0.0.0",
"spec": "0.1.0"
},
"instructions": [
{
"name": "attestNotFilled",
"docs": [
"Permissionlessly attest that an order output was NOT filled before its fill deadline.",
"`order_id` is the input chain order identifier. Is not validated.",
"`output` is the output mandate that was not filled. Must target this settler on this chain.",
"`fill_deadline` is the fill deadline of the order; the current time must strictly exceed it."
],
"discriminator": [
93,
101,
204,
135,
226,
64,
5,
137
],
"accounts": [
{
"name": "payer",
"docs": [
"Permissionless payer funding the created `LocalAttestation` account."
],
"writable": true,
"signer": true
},
{
"name": "outputSettlerSimple",
"pda": {
"seeds": [
{
"kind": "const",
"value": [
111,
117,
116,
112,
117,
116,
95,
115,
101,
116,
116,
108,
101,
114,
95,
115,
105,
109,
112,
108,
101
]
}
]
}
},
{
"name": "fillId",
"docs": [
"The `FillId` PDA for this output. It is created (`init`) during a fill, so it must be",
"un-initialised (system-owned, empty) here to prove no fill exists. The seed derivation is",
"owned by `output_settler_simple` (same scheme as `fill.rs`). Not `init`'d — only its address",
"is asserted so the account existence check inside the base trait is meaningful.",
"Supply this PDA explicitly. Anchor cannot represent the existing hashed seed expression. Use the canonical order/output hash and original program seeds; see this bundle's README.md. Runtime constraints are unchanged."
]
},
{
"name": "localAttestation",
"writable": true
},
{
"name": "intentsProtocolProgram",
"address": "LiFixdGLT5CMdLsHBvaijTXpPy4Uux9Y53SXkuR4HaK"
},
{
"name": "systemProgram",
"address": "11111111111111111111111111111111"
}
],
"args": [
{
"name": "orderId",
"type": {
"array": [
"u8",
32
]
}
},
{
"name": "mandateOutput",
"type": {
"defined": {
"name": "mandateOutput"
}
}
},
{
"name": "fillDeadline",
"type": "u32"
}
]
},
{
"name": "closeFillRecord",
"docs": [
"Permissionlessly close a `FillRecord` strictly after its stamped",
"`close_after`, returning the rent to the filler recorded at fill time",
"(never the caller).",
"`order_id` and `output_hash` address the record; no order data is read."
],
"discriminator": [
60,
96,
240,
102,
51,
185,
23,
34
],
"accounts": [
{
"name": "payer",
"docs": [
"Permissionless caller; pays only the transaction fee and receives",
"nothing."
],
"signer": true
},
{
"name": "fillRecord",
"writable": true,
"pda": {
"seeds": [
{
"kind": "arg",
"path": "orderId"
},
{
"kind": "arg",
"path": "outputHash"
}
]
}
},
{
"name": "rentRefund",
"docs": [
"receives the account's lamports."
],
"writable": true
}
],
"args": [
{
"name": "orderId",
"type": {
"array": [
"u8",
32
]
}
},
{
"name": "outputHash",
"type": {
"array": [
"u8",
32
]
}
}
]
},
{
"name": "fill",
"docs": [
"Fill an order output.",
"`order_id` is the input chain order identifier. Is not validated.",
"`output` is the output mandate to be filled.",
"`fill_deadline` is the maximum time in seconds the fill may be executed at.",
"`filler_data` contains the solver identifier sent to the input chain."
],
"discriminator": [
168,
96,
183,
163,
92,
10,
40,
160
],
"accounts": [
{
"name": "filler",
"writable": true,
"signer": true
},
{
"name": "recipient",
"writable": true
},
{
"name": "outputSettlerSimple",
"pda": {
"seeds": [
{
"kind": "const",
"value": [
111,
117,
116,
112,
117,
116,
95,
115,
101,
116,
116,
108,
101,
114,
95,
115,
105,
109,
112,
108,
101
]
}
]
}
},
{
"name": "fillerTokenAccount",
"writable": true,
"pda": {
"seeds": [
{
"kind": "account",
"path": "filler"
},
{
"kind": "account",
"path": "tokenProgram"
},
{
"kind": "account",
"path": "mint"
}
],
"program": {
"kind": "const",
"value": [
140,
151,
37,
143,
78,
36,
137,
241,
187,
61,
16,
41,
20,
142,
13,
131,
11,
90,
19,
153,
218,
255,
16,
132,
4,
142,
123,
216,
219,
233,
248,
89
]
}
}
},
{
"name": "recipientTokenAccount",
"writable": true,
"pda": {
"seeds": [
{
"kind": "account",
"path": "recipient"
},
{
"kind": "account",
"path": "tokenProgram"
},
{
"kind": "account",
"path": "mint"
}
],
"program": {
"kind": "const",
"value": [
140,
151,
37,
143,
78,
36,
137,
241,
187,
61,
16,
41,
20,
142,
13,
131,
11,
90,
19,
153,
218,
255,
16,
132,
4,
142,
123,
216,
219,
233,
248,
89
]
}
}
},
{
"name": "mint"
},
{
"name": "fillRecord",
"writable": true,
"docs": [
"Supply this PDA explicitly. Anchor cannot represent the existing hashed seed expression. Use the canonical order/output hash and original program seeds; see this bundle's README.md. Runtime constraints are unchanged."
]
},
{
"name": "localAttestation",
"writable": true
},
{
"name": "intentsProtocolProgram",
"address": "LiFixdGLT5CMdLsHBvaijTXpPy4Uux9Y53SXkuR4HaK"
},
{
"name": "tokenProgram"
},
{
"name": "associatedTokenProgram",
"address": "ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL"
},
{
"name": "systemProgram",
"address": "11111111111111111111111111111111"
}
],
"args": [
{
"name": "orderId",
"type": {
"array": [
"u8",
32
]
}
},
{
"name": "mandateOutput",
"type": {
"defined": {
"name": "mandateOutput"
}
}
},
{
"name": "fillDeadline",
"type": "u64"
},
{
"name": "fillerData",
"type": "bytes"
}
],
"returns": "pubkey"
},
{
"name": "fillSamechain",
"docs": [
"Fill the single token output of a compact same-chain order.",
"Warning: Compact same-chain fills must execute after a matching finalise_with_prefill in the same transaction. They do not create a LocalAttestation. Never submit them independently or substitute them for ordinary attested fills.",
"finalise_with_prefill checks for a matching future compact fill and binds the supplied order ID to the expanded order before releasing the input escrow. The compact fill handlers do not enforce a preceding settlement instruction themselves. A standalone compact fill can pay the output while producing an unclaimable fill, without the proof needed for ordinary later finalisation.",
"Required instruction order, all in one transaction: finalise_with_prefill(orderId) -> fill_samechain(args)."
],
"discriminator": [
41,
219,
215,
115,
27,
174,
177,
210
],
"accounts": [
{
"name": "filler",
"writable": true,
"signer": true
},
{
"name": "recipient",
"docs": [
"attestation PDAs commit to it and the input-side order-id validation pins it."
],
"writable": true
},
{
"name": "outputSettlerSimple",
"pda": {
"seeds": [
{
"kind": "const",
"value": [
111,
117,
116,
112,
117,
116,
95,
115,
101,
116,
116,
108,
101,
114,
95,
115,
105,
109,
112,
108,
101
]
}
]
}
},
{
"name": "fillerTokenAccount",
"writable": true,
"pda": {
"seeds": [
{
"kind": "account",
"path": "filler"
},
{
"kind": "account",
"path": "tokenProgram"
},
{
"kind": "account",
"path": "mint"
}
],
"program": {
"kind": "const",
"value": [
140,
151,
37,
143,
78,
36,
137,
241,
187,
61,
16,
41,
20,
142,
13,
131,
11,
90,
19,
153,
218,
255,
16,
132,
4,
142,
123,
216,
219,
233,
248,
89
]
}
}
},
{
"name": "recipientTokenAccount",
"writable": true,
"pda": {
"seeds": [
{
"kind": "account",
"path": "recipient"
},
{
"kind": "account",
"path": "tokenProgram"
},
{
"kind": "account",
"path": "mint"
}
],
"program": {
"kind": "const",
"value": [
140,
151,
37,
143,
78,
36,
137,
241,
187,
61,
16,
41,
20,
142,
13,
131,
11,
90,
19,
153,
218,
255,
16,
132,
4,
142,
123,
216,
219,
233,
248,
89
]
}
}
},
{
"name": "mint"
},
{
"name": "fillRecord",
"writable": true,
"docs": [
"Supply this PDA explicitly. Anchor cannot represent the existing hashed seed expression. Use the canonical order/output hash and original program seeds; see this bundle's README.md. Runtime constraints are unchanged."
]
},
{
"name": "tokenProgram"
},
{
"name": "associatedTokenProgram",
"address": "ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL"
},
{
"name": "systemProgram",
"address": "11111111111111111111111111111111"
}
],
"args": [
{
"name": "args",
"type": {
"defined": {
"name": "fillSamechainArgs"
}
}
}
],
"returns": "pubkey"
},
{
"name": "initialize",
"docs": [
"Creates `output settler simple` PDA.",
"`output settler simple` PDA is used to store the chain identifier."
],
"discriminator": [
175,
175,
109,
31,
13,
152,
155,
237
],
"accounts": [
{
"name": "deployer",
"writable": true,
"signer": true
},
{
"name": "chainId"
},
{
"name": "outputSettlerSimple",
"writable": true,
"pda": {
"seeds": [
{
"kind": "const",
"value": [
111,
117,
116,
112,
117,
116,
95,
115,
101,
116,
116,
108,
101,
114,
95,
115,
105,
109,
112,
108,
101
]
}
]
}
},
{
"name": "intentsProtocolProgram",
"address": "LiFixdGLT5CMdLsHBvaijTXpPy4Uux9Y53SXkuR4HaK"
},
{
"name": "systemProgram",
"address": "11111111111111111111111111111111"
}
],
"args": [],
"returns": "pubkey"
},
{
"name": "nativeFill",
"docs": [
"Fill an order output with native SOL.",
"`order_id` is the input chain order identifier. Is not validated.",
"`output` is the output mandate to be filled.",
"`fill_deadline` is the maximum time in seconds the fill may be executed at.",
"`filler_data` contains the solver identifier sent to the input chain."
],
"discriminator": [
49,
10,
255,
151,
120,
148,
73,
30
],
"accounts": [
{
"name": "filler",
"writable": true,
"signer": true
},
{
"name": "recipient",
"writable": true
},
{
"name": "outputSettlerSimple",
"pda": {
"seeds": [
{
"kind": "const",
"value": [
111,
117,
116,
112,
117,
116,
95,
115,
101,
116,
116,
108,
101,
114,
95,
115,
105,
109,
112,
108,
101
]
}
]
}
},
{
"name": "fillRecord",
"writable": true,
"docs": [
"Supply this PDA explicitly. Anchor cannot represent the existing hashed seed expression. Use the canonical order/output hash and original program seeds; see this bundle's README.md. Runtime constraints are unchanged."
]
},
{
"name": "localAttestation",
"writable": true
},
{
"name": "intentsProtocolProgram",
"address": "LiFixdGLT5CMdLsHBvaijTXpPy4Uux9Y53SXkuR4HaK"
},
{
"name": "systemProgram",
"address": "11111111111111111111111111111111"
}
],
"args": [
{
"name": "orderId",
"type": {
"array": [
"u8",
32
]
}
},
{
"name": "mandateOutput",
"type": {
"defined": {
"name": "mandateOutput"
}
}
},
{
"name": "fillDeadline",
"type": "u64"
},
{
"name": "fillerData",
"type": "bytes"
}
],
"returns": "pubkey"
},
{
"name": "nativeFillSamechain",
"docs": [
"Fill the single native SOL output of a compact same-chain order.",
"Warning: Compact same-chain fills must execute after a matching finalise_with_prefill in the same transaction. They do not create a LocalAttestation. Never submit them independently or substitute them for ordinary attested fills.",
"finalise_with_prefill checks for a matching future compact fill and binds the supplied order ID to the expanded order before releasing the input escrow. The compact fill handlers do not enforce a preceding settlement instruction themselves. A standalone compact fill can pay the output while producing an unclaimable fill, without the proof needed for ordinary later finalisation.",
"Required instruction order, all in one transaction: finalise_with_prefill(orderId) -> native_fill_samechain(args)."
],
"discriminator": [
246,
44,
97,
75,
180,
183,
72,
72
],
"accounts": [
{
"name": "filler",
"writable": true,
"signer": true
},
{
"name": "recipient",
"docs": [
"attestation PDAs commit to it and the input-side order-id validation pins it."
],
"writable": true
},
{
"name": "outputSettlerSimple",
"pda": {
"seeds": [
{
"kind": "const",
"value": [
111,
117,
116,
112,
117,
116,
95,
115,
101,
116,
116,
108,
101,
114,
95,
115,
105,
109,
112,
108,
101
]
}
]
}
},
{
"name": "fillRecord",
"writable": true,
"docs": [
"Supply this PDA explicitly. Anchor cannot represent the existing hashed seed expression. Use the canonical order/output hash and original program seeds; see this bundle's README.md. Runtime constraints are unchanged."
]
},
{
"name": "systemProgram",
"address": "11111111111111111111111111111111"
}
],
"args": [
{
"name": "args",
"type": {
"defined": {
"name": "fillSamechainArgs"
}
}
}
],
"returns": "pubkey"
}
],
"accounts": [
{
"name": "chainId",
"discriminator": [
203,
146,
201,
161,
230,
71,
157,
218
]
},
{
"name": "fillRecord",
"discriminator": [
27,
79,
245,
54,
39,
229,
168,
24
]
},
{
"name": "outputSettlerSimpleAccount",
"discriminator": [
227,
35,
185,
166,
177,
53,
143,
129
]
}
],
"events": [
{
"name": "fillRecordClosedEvent",
"discriminator": [
70,
227,
88,
40,
245,
228,
143,
59
]
},
{
"name": "outputFilledEvent",
"discriminator": [
43,
25,
133,
52,
107,
176,
40,
213
]
},
{
"name": "outputNotFilledEvent",
"discriminator": [
162,
22,
108,
52,
116,
186,
115,
37
]
}
],
"errors": [
{
"code": 6500,
"name": "notImplemented",
"msg": "Order type not implemented."
},
{
"code": 6501,
"name": "amountTooLarge",
"msg": "Amount is too large."
},
{
"code": 6502,
"name": "arithmeticOverflow",
"msg": "Arithmetic overflow."
},
{
"code": 6503,
"name": "invalidFillerData",
"msg": "Invalid filler data."
},
{
"code": 6504,
"name": "invalidContextDataLength",
"msg": "Invalid context data length."
},
{
"code": 6505,
"name": "exclusiveTo",
"msg": "Order is exclusive to another solver or time passed."
},
{
"code": 6506,
"name": "zeroValue",
"msg": "Zero value is not allowed."
},
{
"code": 6507,
"name": "notTopLevel",
"msg": "Compact same-chain fills must be invoked as top-level instructions."
},
{
"code": 6508,
"name": "fillRecordNotClosable",
"msg": "Fill record is not closable yet."
},
{
"code": 6509,
"name": "invalidRentRefund",
"msg": "Rent refund account does not match the recorded rent refund."
}
],
"types": [
{
"name": "chainId",
"docs": [
"Type used to store the chain id of the chain."
],
"type": {
"kind": "struct",
"fields": [
{
"name": "chainId",
"type": "u128"
},
{
"name": "bump",
"type": "u8"
}
]
}
},
{
"name": "compactSamechainContext",
"docs": [
"The only pricing contexts accepted by the compact input-first path.",
"",
"Variant order is wire ABI: do not reorder. Both exclusive variants expand to the canonical",
"`0xe0 || exclusive_for || start_time_be` context; `ExclusiveForSelf` is a transport",
"optimization that substitutes the current solver for `exclusive_for`."
],
"type": {
"kind": "enum",
"variants": [
{
"name": "none"
},
{
"name": "exclusiveFor",
"fields": [
{
"name": "exclusiveFor",
"type": {
"array": [
"u8",
32
]
}
},
{
"name": "startTime",
"type": "u32"
}
]
},
{
"name": "exclusiveForSelf",
"fields": [
{
"name": "startTime",
"type": "u32"
}
]
}
]
}
},
{
"name": "compactSamechainOrder",
"docs": [
"Compact, same-chain-only representation carried by `fill_samechain` instructions.",
"",
"Fields recoverable from the input and output instruction accounts are deliberately omitted.",
"Every protocol hash and PDA is derived from the canonical `StandardOrder` or `MandateOutput`",
"encoding reconstructed by expansion, never from the compact bytes themselves."
],
"type": {
"kind": "struct",
"fields": [
{
"name": "nonce",
"type": "u128"
},
{
"name": "expires",
"type": "u32"
},
{
"name": "fillDeadline",
"type": "u32"
},
{
"name": "inputAmount",
"type": "u64"
},
{
"name": "outputAmount",
"type": "u64"
},
{
"name": "context",
"type": {
"defined": {
"name": "compactSamechainContext"
}
}
}
]
}
},
{
"name": "fillRecord",
"docs": [
"Created during fill to ensure no double fill for the same output, and read",
"by `attest_not_filled` as the proof-of-fill via its *absence* check. Lives at",
"the PDA seeds `[order_id, mandate_output_hash]`.",
"",
"`rent_refund` is the filler that funded the account; `close_after` is",
"`fill_deadline + NOT_FILLED_WINDOW_SECONDS`, stamped identically in all four",
"fill paths and immutable afterwards. The permissionless `close_fill_record`",
"reclaims the rent to `rent_refund` strictly after `close_after`."
],
"type": {
"kind": "struct",
"fields": [
{
"name": "rentRefund",
"type": "pubkey"
},
{
"name": "closeAfter",
"type": "u64"
}
]
}
},
{
"name": "fillRecordClosedEvent",
"docs": [
"Emitted when a `FillRecord` past its `close_after` is closed and its rent",
"returned to the filler recorded at fill time."
],
"type": {
"kind": "struct",
"fields": [
{
"name": "orderId",
"type": {
"array": [
"u8",
32
]
}
},
{
"name": "outputHash",
"type": {
"array": [
"u8",
32
]
}
},
{
"name": "rentRefund",
"type": "pubkey"
}
]
}
},
{
"name": "fillSamechainArgs",
"docs": [
"Shared instruction payload for token and native compact same-chain fills."
],
"type": {
"kind": "struct",
"fields": [
{
"name": "orderId",
"type": {
"array": [
"u8",
32
]
}
},
{
"name": "order",
"type": {
"defined": {
"name": "compactSamechainOrder"
}
}
}
]
}
},
{
"name": "mandateOutput",
"docs": [
"Defines the output state and where and how it should be filled.",
"DEV NOTES:",
"`oracle`: the implementation responsible for collecting the proof from settler on output chain",
"`settler`: the implementation on the output chain responsible for settling the output payment.",
"`callback_data`: the data to be passed to the callback function. MUST be empty if no callback is needed.",
"`context`: The output context for the output settlement, encoding order types or other information."
],
"type": {
"kind": "struct",
"fields": [
{
"name": "oracle",
"type": {
"array": [
"u8",
32
]
}
},
{
"name": "settler",
"type": {
"array": [
"u8",
32
]
}
},
{
"name": "chainId",
"type": {
"array": [
"u8",
32
]
}
},
{
"name": "token",
"type": {
"array": [
"u8",
32
]
}
},
{
"name": "amount",
"type": {
"array": [
"u8",
32
]
}
},
{
"name": "recipient",
"type": {
"array": [
"u8",
32
]
}
},
{
"name": "callbackData",
"type": "bytes"
},
{
"name": "context",
"type": "bytes"
}
]
}
},
{
"name": "outputFilledEvent",
"docs": [
"IDL-only mirrors of the events emitted by `output_settler_base`.",
"",
"The events are emitted from inside `output_settler_base` (see",
"`base.rs`), but Anchor's IDL generator only collects `#[event]` structs",
"defined in the program crate itself, so without these mirrors the events",
"are silently absent from the published IDL. Anchor identifies an event by",
"its name-derived discriminator (`sha256(\"event:<Name>\")[..8]`) and its",
"borsh field layout, so an identical copy here yields the exact IDL entry",
"for the event the base crate emits. The tests below pin the mirrors to the",
"base-crate originals byte-for-byte."
],
"type": {
"kind": "struct",
"fields": [
{
"name": "settler",
"type": "pubkey"
},
{
"name": "orderId",
"type": {
"array": [
"u8",
32
]
}
},
{
"name": "solver",
"type": {
"array": [
"u8",
32
]
}
},
{
"name": "timestamp",
"type": "u32"
},
{
"name": "output",
"type": {
"defined": {
"name": "mandateOutput"
}
}
},
{
"name": "finalAmount",
"type": "u64"
}
]
}
},
{
"name": "outputNotFilledEvent",
"docs": [
"Informational event emitted when an output is provably attested as not filled before its fill",
"deadline. Mirrors the EVM `OutputNotFilled(orderId, output, fillDeadline)` event."
],
"type": {
"kind": "struct",
"fields": [
{
"name": "settler",
"type": "pubkey"
},
{
"name": "orderId",
"type": {
"array": [
"u8",
32
]
}
},
{
"name": "fillDeadline",
"type": "u32"
},
{
"name": "output",
"type": {
"defined": {
"name": "mandateOutput"
}
}
}
]
}
},
{
"name": "outputSettlerSimpleAccount",
"docs": [
"Represents the output settler implementation type.",
"Implements the `OutputSettlerBaseTrait` trait."
],
"type": {
"kind": "struct",
"fields": [
{
"name": "chainId",
"type": "u128"
},
{
"name": "bump",
"type": "u8"
}
]
}
}
]
};
types/polymer.ts
types/polymer.ts
polymer.ts
/** Generated by yarn idl:generate. Runtime IDL: ../polymer.json. */
export type Polymer = {
"address": "LiFiBtfyPT1DnTHTAeZ2rwr5RgMrThwA5kt7KGT5nBV",
"metadata": {
"name": "polymer",
"version": "0.0.0",
"spec": "0.1.0"
},
"docs": [
"There are two ways to receive a remote proof, both ending in",
"[`receive_attest`] which reads the validated event data from the prover's",
"`result_account` and registers the attestation:",
"",
"1. **Single step** — call [`receive_load_proof`] with the full proof. It",
"runs the prover's `create_accounts`, `load_proof` and `validate_event`",
"CPIs in one transaction, then `receive_attest` finalises it. Use this",
"when the proof fits within a single Solana transaction.",
"",
"2. **Three steps** — for proofs too large to fit in a single Solana",
"transaction, the load is chunked across multiple transactions:",
"1. [`create_polymer_accounts`] — create the prover's `cache`/`result` PDAs.",
"2. [`load_proof_chunk`] — append one chunk of the proof; call once per",
"chunk until the full proof is loaded (the prover extends the cache).",
"3. [`validate_event`] — validate the accumulated proof in the cache.",
"Then `receive_attest` finalises it as above."
],
"instructions": [
{
"name": "createPolymerAccounts",
"docs": [
"Chunked receive step 1: create the polymer prover's `cache` and",
"`result` scratch PDAs. Use this path instead of `receive_load_proof`",
"when the proof is too large to load in a single transaction."
],
"discriminator": [
238,
43,
4,
23,
70,
95,
159,
84
],
"accounts": [
{
"name": "signer",
"writable": true,
"signer": true
},
{
"name": "oraclePolymer",
"pda": {
"seeds": [
{
"kind": "const",
"value": [
112,
111,
108,
121,
109,
101,
114
]
}
]
}
},
{
"name": "polymerProverProgram"
},
{
"name": "cacheAccount",
"writable": true
},
{
"name": "resultAccount",
"writable": true
},
{
"name": "systemProgram",
"address": "11111111111111111111111111111111"
}
],
"args": []
},
{
"name": "initialize",
"docs": [
"Initializes the `oracle_polymer` account. Creates `oracle_polymer` PDA and sets the `polymer_prover_id`.",
"`oracle_polymer` PDA is used to store the chain identifier and the owner address."
],
"discriminator": [
175,
175,
109,
31,
13,
152,
155,
237
],
"accounts": [
{
"name": "deployer",
"writable": true,
"signer": true
},
{
"name": "chainId"
},
{
"name": "oraclePolymer",
"writable": true,
"pda": {
"seeds": [
{
"kind": "const",
"value": [
112,
111,
108,
121,
109,
101,
114
]
}
]
}
},
{
"name": "intentsProtocolProgram",
"address": "LiFixdGLT5CMdLsHBvaijTXpPy4Uux9Y53SXkuR4HaK"
},
{
"name": "systemProgram",
"address": "11111111111111111111111111111111"
}
],
"args": [
{
"name": "polymerProverId",
"type": "pubkey"
}
]
},
{
"name": "loadProofChunk",
"docs": [
"Chunked receive step 2: append a single chunk of the proof into the",
"prover's `cache` PDA. Call repeatedly until the full proof is loaded."
],
"discriminator": [
252,
35,
79,
22,
76,
152,
132,
74
],
"accounts": [
{
"name": "signer",
"writable": true,
"signer": true
},
{
"name": "oraclePolymer",
"pda": {
"seeds": [
{
"kind": "const",
"value": [
112,
111,
108,
121,
109,
101,
114
]
}
]
}
},
{
"name": "polymerProverProgram"
},
{
"name": "cacheAccount",
"writable": true
}
],
"args": [
{
"name": "proofChunk",
"type": "bytes"
}
]
},
{
"name": "receiveAttest",
"docs": [
"Step 2 of receive: read the validated event data left by",
"`receive_load_proof`, register the attestation, and close the polymer",
"prover's scratch PDAs."
],
"discriminator": [
112,
136,
131,
35,
95,
206,
124,
161
],
"accounts": [
{
"name": "signer",
"writable": true,
"signer": true
},
{
"name": "oraclePolymer",
"pda": {
"seeds": [
{
"kind": "const",
"value": [
112,
111,
108,
121,
109,
101,
114
]
}
]
}
},
{
"name": "polymerProverProgram"
},
{
"name": "chainMapping"
},
{
"name": "cacheAccount",
"writable": true
},
{
"name": "internal",
"writable": true
},
{
"name": "resultAccount",
"writable": true
},
{
"name": "attestation",
"writable": true
},
{
"name": "intentsProtocolProgram",
"address": "LiFixdGLT5CMdLsHBvaijTXpPy4Uux9Y53SXkuR4HaK"
},
{
"name": "systemProgram",
"address": "11111111111111111111111111111111"
}
],
"args": []
},
{
"name": "receiveLoadProof",
"docs": [
"Step 1 of receive: load and validate a single proof via the polymer",
"prover. Leaves the validated event data in `result_account` for",
"`receive_attest` to consume in a follow-up tx."
],
"discriminator": [
220,
77,
15,
159,
191,
141,
155,
51
],
"accounts": [
{
"name": "signer",
"writable": true,
"signer": true
},
{
"name": "oraclePolymer",
"pda": {
"seeds": [
{
"kind": "const",
"value": [
112,
111,
108,
121,
109,
101,
114
]
}
]
}
},
{
"name": "polymerProverProgram"
},
{
"name": "cacheAccount",
"writable": true
},
{
"name": "internal",
"writable": true
},
{
"name": "resultAccount",
"writable": true
},
{
"name": "systemProgram",
"address": "11111111111111111111111111111111"
}
],
"args": [
{
"name": "proof",
"type": "bytes"
}
]
},
{
"name": "setChainMapping",
"docs": [
"Maps polymer chain id to a configured custom chain id.",
"Can only be called by the owner of the `oracle_polymer` account.",
"Each mapping may only be set once."
],
"discriminator": [
174,
145,
44,
171,
203,
101,
230,
130
],
"accounts": [
{
"name": "signer",
"writable": true,
"signer": true
},
{
"name": "oraclePolymer",
"pda": {
"seeds": [
{
"kind": "const",
"value": [
112,
111,
108,
121,
109,
101,
114
]
}
]
}
},
{
"name": "chainMapping",
"writable": true
},
{
"name": "intentsProtocolProgram",
"address": "LiFixdGLT5CMdLsHBvaijTXpPy4Uux9Y53SXkuR4HaK"
},
{
"name": "systemProgram",
"address": "11111111111111111111111111111111"
}
],
"args": [
{
"name": "protocolChainId",
"type": "u128"
},
{
"name": "chainId",
"type": "u128"
}
]
},
{
"name": "submit",
"docs": [
"Permissionlessly validates and logs proofs, retaining their local attestations",
"and rent for repeat submissions. Requires one read-only attestation per payload.",
"Remaining accounts: exactly one read-only local_attestation per fill_descriptions entry, in payload order. No remaining-account signers or refund slots. Payloads must not be empty. This instruction retains attestations for repeat submissions."
],
"discriminator": [
88,
166,
102,
181,
162,
127,
170,
48
],
"accounts": [
{
"name": "oraclePolymer",
"pda": {
"seeds": [
{
"kind": "const",
"value": [
112,
111,
108,
121,
109,
101,
114
]
}
]
}
}
],
"args": [
{
"name": "source",
"type": "pubkey"
},
{
"name": "fillDescriptions",
"type": {
"vec": "bytes"
}
}
]
},
{
"name": "submitConsume",
"docs": [
"Validates, consumes and logs proofs, returning rent when possible.",
"Every fill requires its recorded filler to sign as `submitter`.",
"Not-filled proofs remain permissionless. Requires one writable",
"`(local_attestation, rent_refund)` pair per payload.",
"Remaining accounts: exactly [local_attestation_0, rent_refund_0, ..., local_attestation_N-1, rent_refund_N-1] in fill_descriptions order. Payloads must not be empty. Both accounts in every pair must be writable; no additional remaining-account signers.",
"Each rent_refund must be the attestation's stored recipient. Executable recipients defer reclamation; keep both writable. Every fill payload requires its recorded filler to sign as the named submitter; not-filled payloads remain permissionless."
],
"discriminator": [
19,
162,
196,
241,
27,
133,
47,
49
],
"accounts": [
{
"name": "submitter",
"docs": [
"Must be the recorded rent-refund recipient (the filler) for every fill",
"payload. Not-filled payloads may be submitted by any signer."
],
"writable": true,
"signer": true
},
{
"name": "oraclePolymer",
"pda": {
"seeds": [
{
"kind": "const",
"value": [
112,
111,
108,
121,
109,
101,
114
]
}
]
}
},
{
"name": "localConsumer",
"docs": [
"no data). The committed consumer of Polymer-routed attestations is this",
"PROGRAM ID, which cannot sign; the intents protocol accepts this PDA as",
"the program's consumption authority instead."
],
"pda": {
"seeds": [
{
"kind": "const",
"value": [
108,
111,
99,
97,
108,
95,
99,
111,
110,
115,
117,
109,
101,
114
]
}
]
}
},
{
"name": "intentsProtocolProgram",
"address": "LiFixdGLT5CMdLsHBvaijTXpPy4Uux9Y53SXkuR4HaK"
}
],
"args": [
{
"name": "source",
"type": "pubkey"
},
{
"name": "fillDescriptions",
"type": {
"vec": "bytes"
}
}
]
},
{
"name": "validateEvent",
"docs": [
"Chunked receive step 3: validate the proof accumulated in the `cache`",
"PDA, leaving the validated event data in `result_account` for",
"`receive_attest` to consume in a follow-up tx."
],
"discriminator": [
66,
249,
207,
221,
30,
87,
27,
129
],
"accounts": [
{
"name": "signer",
"writable": true,
"signer": true
},
{
"name": "oraclePolymer",
"pda": {
"seeds": [
{
"kind": "const",
"value": [
112,
111,
108,
121,
109,
101,
114
]
}
]
}
},
{
"name": "polymerProverProgram"
},
{
"name": "cacheAccount",
"writable": true
},
{
"name": "internal",
"writable": true
},
{
"name": "resultAccount",
"writable": true
}
],
"args": []
}
],
"accounts": [
{
"name": "chainId",
"discriminator": [
203,
146,
201,
161,
230,
71,
157,
218
]
},
{
"name": "chainMapping",
"discriminator": [
81,
78,
77,
209,
44,
206,
85,
169
]
},
{
"name": "oraclePolymer",
"discriminator": [
30,
219,
153,
176,
126,
163,
80,
138
]
}
],
"events": [
{
"name": "outputProvenEvent",
"discriminator": [
85,
190,
185,
8,
90,
48,
3,
214
]
}
],
"errors": [
{
"code": 6700,
"name": "invalidChainId",
"msg": "Invalid chain id"
},
{
"code": 6701,
"name": "invalidProof",
"msg": "Invalid proof"
},
{
"code": 6702,
"name": "invalidOutputChainId",
"msg": "Invalid output chain id"
},
{
"code": 6703,
"name": "unauthorized",
"msg": "Unauthorized mapping creation"
},
{
"code": 6704,
"name": "couldNotDecodeSolver",
"msg": "Could not decode solver"
},
{
"code": 6705,
"name": "couldNotDecodeTimestamp",
"msg": "Could not decode timestamp"
},
{
"code": 6706,
"name": "couldNotDecodeMandateOutputFieldsTuple",
"msg": "Could not decode mandate output fields tuple"
},
{
"code": 6707,
"name": "couldNotDecodeOracle",
"msg": "Could not decode oracle"
},
{
"code": 6708,
"name": "couldNotDecodeSettler",
"msg": "Could not decode settler"
},
{
"code": 6709,
"name": "couldNotDecodeChainId",
"msg": "Could not decode chain id"
},
{
"code": 6710,
"name": "couldNotDecodeToken",
"msg": "Could not decode token"
},
{
"code": 6711,
"name": "couldNotDecodeAmount",
"msg": "Could not decode amount"
},
{
"code": 6712,
"name": "couldNotDecodeRecipient",
"msg": "Could not decode recipient"
},
{
"code": 6713,
"name": "couldNotDecodeCallbackData",
"msg": "Could not decode callback data"
},
{
"code": 6714,
"name": "couldNotDecodeContext",
"msg": "Could not decode context"
},
{
"code": 6715,
"name": "couldNotDecodeFinalAmount",
"msg": "Could not decode final amount"
},
{
"code": 6716,
"name": "couldNotConvertU256ToU64",
"msg": "Could not convert u128 to u64"
},
{
"code": 6717,
"name": "couldNotConvertU256ToU128",
"msg": "Could not convert u256 to u128"
},
{
"code": 6718,
"name": "couldNotConvertU256ToU32",
"msg": "Could not convert u256 to u32"
},
{
"code": 6719,
"name": "noAttestationsProvided",
"msg": "No attestations provided"
},
{
"code": 6720,
"name": "notCorrectEncodedTypes",
"msg": "Not correct encoded types"
},
{
"code": 6721,
"name": "wrongEventSignature",
"msg": "Event signature topic does not match OutputFilled or OutputNotFilled"
},
{
"code": 6722,
"name": "unauthorizedFillSubmitter",
"msg": "Fill submission requires the filler to sign as submitter"
}
],
"types": [
{
"name": "chainId",
"docs": [
"Type used to store the chain id of the chain."
],
"type": {
"kind": "struct",
"fields": [
{
"name": "chainId",
"type": "u128"
},
{
"name": "bump",
"type": "u8"
}
]
}
},
{
"name": "chainMapping",
"docs": [
"Type used to map a protocol chain identifier to a custom configured chain identifier."
],
"type": {
"kind": "struct",
"fields": [
{
"name": "chainId",
"type": "u128"
},
{
"name": "bump",
"type": "u8"
}
]
}
},
{
"name": "oraclePolymer",
"docs": [
"Represents the `Polymer` oracle implementation type.",
"Implements the `OracleBaseTrait`, `InputOracleBaseTrait` and `OutputOracleBaseTrait` traits.",
"`polymer_prover_id` is the program id of the polymer prover program.",
"`owner` is the owner of the PolymerOracle. The only address to create mappings."
],
"type": {
"kind": "struct",
"fields": [
{
"name": "polymerProverId",
"type": "pubkey"
},
{
"name": "owner",
"type": "pubkey"
},
{
"name": "chainId",
"type": "u128"
},
{
"name": "bump",
"type": "u8"
}
]
}
},
{
"name": "outputProvenEvent",
"docs": [
"IDL-only mirror of the event emitted by `oracle_base`.",
"",
"The event is emitted from inside `oracle_base` (see `base.rs`), but",
"Anchor's IDL generator only collects `#[event]` structs defined in the",
"program crate itself, so without this mirror the event is silently absent",
"from the published IDL. Anchor identifies an event by its name-derived",
"discriminator (`sha256(\"event:<Name>\")[..8]`) and its borsh field layout,",
"so an identical copy here yields the exact IDL entry for the event the",
"base crate emits. The test below pins the mirror to the base-crate",
"original byte-for-byte."
],
"type": {
"kind": "struct",
"fields": [
{
"name": "chainId",
"type": "u128"
},
{
"name": "remoteIdentifier",
"type": {
"array": [
"u8",
32
]
}
},
{
"name": "application",
"type": {
"array": [
"u8",
32
]
}
},
{
"name": "payloadHash",
"type": {
"array": [
"u8",
32
]
}
}
]
}
}
]
};
types/intents_protocol.ts
types/intents_protocol.ts
intents_protocol.ts
/** Generated by yarn idl:generate. Runtime IDL: ../intents_protocol.json. */
export type IntentsProtocol = {
"address": "LiFixdGLT5CMdLsHBvaijTXpPy4Uux9Y53SXkuR4HaK",
"metadata": {
"name": "intentsProtocol",
"version": "0.0.0",
"spec": "0.1.0"
},
"instructions": [
{
"name": "consumeLocalAttestation",
"docs": [
"Consume a local attestation, returning rent immediately unless its",
"recorded recipient is executable. In that case preserve a consumed",
"account for separate cleanup. Callable only by the consumer committed in the",
"attestation's PDA seeds (directly, or via its local-consumer PDA when",
"the committed consumer is a program id), and only with the exact",
"`data_hash` and `timestamp` the attestation commits to — consuming an",
"attestation therefore also validates it."
],
"discriminator": [
161,
130,
104,
3,
101,
250,
155,
239
],
"accounts": [
{
"name": "authority",
"docs": [
"The committed consumer, or its program's canonical local-consumer PDA."
],
"signer": true
},
{
"name": "localAttestation",
"writable": true,
"pda": {
"seeds": [
{
"kind": "const",
"value": [
108,
111,
99,
97,
108,
95,
97,
116,
116,
101,
115,
116,
97,
116,
105,
111,
110
]
},
{
"kind": "arg",
"path": "attestator"
},
{
"kind": "arg",
"path": "consumer"
},
{
"kind": "arg",
"path": "dataHash"
}
]
}
},
{
"name": "rentRefund",
"docs": [
"client and CPI interfaces; executable recipients are never modified."
],
"writable": true
}
],
"args": [
{
"name": "attestator",
"type": "pubkey"
},
{
"name": "consumer",
"type": {
"array": [
"u8",
32
]
}
},
{
"name": "dataHash",
"type": {
"array": [
"u8",
32
]
}
},
{
"name": "timestamp",
"type": "u32"
}
]
},
{
"name": "createAttestation",
"docs": [
"Create an attestation for a remote chain."
],
"discriminator": [
49,
24,
67,
80,
12,
249,
96,
239
],
"accounts": [
{
"name": "payer",
"writable": true,
"signer": true
},
{
"name": "attestator",
"signer": true
},
{
"name": "attestation",
"writable": true,
"pda": {
"seeds": [
{
"kind": "const",
"value": [
97,
116,
116,
101,
115,
116,
97,
116,
105,
111,
110
]
},
{
"kind": "account",
"path": "attestator"
},
{
"kind": "arg",
"path": "chainId"
},
{
"kind": "arg",
"path": "source"
},
{
"kind": "arg",
"path": "application"
},
{
"kind": "arg",
"path": "payloadHash"
}
]
}
},
{
"name": "systemProgram",
"address": "11111111111111111111111111111111"
}
],
"args": [
{
"name": "chainId",
"type": "u128"
},
{
"name": "source",
"type": {
"array": [
"u8",
32
]
}
},
{
"name": "application",
"type": {
"array": [
"u8",
32
]
}
},
{
"name": "payloadHash",
"type": {
"array": [
"u8",
32
]
}
}
]
},
{
"name": "createLocalAttestation",
"docs": [
"Create a local attestation based on the attestation data. The payer is",
"recorded as the rent refund destination for later consumption."
],
"discriminator": [
80,
127,
2,
116,
84,
21,
190,
38
],
"accounts": [
{
"name": "payer",
"writable": true,
"signer": true
},
{
"name": "attestator",
"signer": true
},
{
"name": "localAttestation",
"writable": true,
"pda": {
"seeds": [
{
"kind": "const",
"value": [
108,
111,
99,
97,
108,
95,
97,
116,
116,
101,
115,
116,
97,
116,
105,
111,
110
]
},
{
"kind": "account",
"path": "attestator"
},
{
"kind": "arg",
"path": "consumer"
},
{
"kind": "arg",
"path": "dataHash"
}
]
}
},
{
"name": "systemProgram",
"address": "11111111111111111111111111111111"
}
],
"args": [
{
"name": "consumer",
"type": {
"array": [
"u8",
32
]
}
},
{
"name": "dataHash",
"type": {
"array": [
"u8",
32
]
}
},
{
"name": "timestamp",
"type": "u32"
}
]
},
{
"name": "reclaimLocalAttestationRent",
"docs": [
"Reclaim deferred rent from a consumed attestation. Anyone may call this;",
"rent goes to the recorded payer unless that payer signs to authorize",
"another destination. The destination must be non-executable."
],
"discriminator": [
124,
240,
79,
198,
173,
188,
63,
76
],
"accounts": [
{
"name": "localAttestation",
"writable": true,
"pda": {
"seeds": [
{
"kind": "const",
"value": [
108,
111,
99,
97,
108,
95,
97,
116,
116,
101,
115,
116,
97,
116,
105,
111,
110
]
},
{
"kind": "arg",
"path": "attestator"
},
{
"kind": "arg",
"path": "consumer"
},
{
"kind": "arg",
"path": "dataHash"
}
]
}
},
{
"name": "rentRefund",
"writable": true
},
{
"name": "rentRefundAuthority",
"docs": [
"Required only when returning rent to an address other than the payer.",
"A payer converted into a program can still sign using its original key."
],
"signer": true,
"optional": true
}
],
"args": [
{
"name": "attestator",
"type": "pubkey"
},
{
"name": "consumer",
"type": {
"array": [
"u8",
32
]
}
},
{
"name": "dataHash",
"type": {
"array": [
"u8",
32
]
}
}
]
},
{
"name": "setChainId",
"docs": [
"Set the chain id of the chain."
],
"discriminator": [
57,
174,
29,
202,
84,
216,
7,
148
],
"accounts": [
{
"name": "signer",
"writable": true,
"signer": true
},
{
"name": "chainId",
"writable": true,
"pda": {
"seeds": [
{
"kind": "const",
"value": [
99,
104,
97,
105,
110,
95,
105,
100
]
}
]
}
},
{
"name": "systemProgram",
"address": "11111111111111111111111111111111"
}
],
"args": [
{
"name": "chainId",
"type": "u128"
}
]
},
{
"name": "setChainMapping",
"docs": [
"Set the real chain id for a protocol chain id.",
"Dev:",
"`protocol_chain_id` is the protocol chain identifier.",
"`chain_id` is the real chain identifier."
],
"discriminator": [
174,
145,
44,
171,
203,
101,
230,
130
],
"accounts": [
{
"name": "signer",
"writable": true,
"signer": true
},
{
"name": "oracle",
"signer": true
},
{
"name": "chainMapping",
"writable": true,
"pda": {
"seeds": [
{
"kind": "const",
"value": [
99,
104,
97,
105,
110,
95,
109,
97,
112,
112,
105,
110,
103
]
},
{
"kind": "account",
"path": "oracle"
},
{
"kind": "arg",
"path": "protocolChainId"
}
]
}
},
{
"name": "systemProgram",
"address": "11111111111111111111111111111111"
}
],
"args": [
{
"name": "protocolChainId",
"type": "u128"
},
{
"name": "chainId",
"type": "u128"
}
]
}
],
"accounts": [
{
"name": "attestation",
"discriminator": [
152,
125,
183,
86,
36,
146,
121,
73
]
},
{
"name": "chainId",
"discriminator": [
203,
146,
201,
161,
230,
71,
157,
218
]
},
{
"name": "chainMapping",
"discriminator": [
81,
78,
77,
209,
44,
206,
85,
169
]
},
{
"name": "localAttestation",
"discriminator": [
173,
247,
101,
168,
96,
238,
17,
22
]
}
],
"events": [
{
"name": "attestationCreatedEvent",
"discriminator": [
157,
10,
208,
90,
87,
62,
175,
26
]
},
{
"name": "chainIdConfiguredEvent",
"discriminator": [
92,
39,
243,
11,
30,
97,
80,
219
]
},
{
"name": "chainMapConfiguredEvent",
"discriminator": [
157,
35,
137,
206,
200,
100,
92,
171
]
},
{
"name": "localAttestationConsumedEvent",
"discriminator": [
238,
77,
179,
71,
131,
58,
164,
104
]
},
{
"name": "localAttestationCreatedEvent",
"discriminator": [
173,
59,
45,
101,
206,
241,
125,
25
]
},
{
"name": "localAttestationRentDeferredEvent",
"discriminator": [
20,
52,
250,
84,
165,
187,
163,
219
]
},
{
"name": "localAttestationRentReclaimedEvent",
"discriminator": [
142,
21,
161,
230,
143,
239,
210,
124
]
}
],
"errors": [
{
"code": 6100,
"name": "invalidOracle",
"msg": "Invalid oracle"
},
{
"code": 6101,
"name": "invalidLocalAttestationTimestamp",
"msg": "Invalid local attestation timestamp"
},
{
"code": 6102,
"name": "invalidChainMappingAccount",
"msg": "Invalid chain mapping account"
},
{
"code": 6103,
"name": "invalidLocalAttestationAccount",
"msg": "Invalid local attestation account"
},
{
"code": 6104,
"name": "invalidAttestationAccount",
"msg": "Invalid attestation account"
},
{
"code": 6105,
"name": "invalidChainIdAccount",
"msg": "Invalid chain id account"
},
{
"code": 6106,
"name": "unauthorizedLocalAttestationConsumer",
"msg": "Signer is not the attestation's committed consumer"
},
{
"code": 6107,
"name": "invalidRentRefundAccount",
"msg": "Rent refund account does not match the stored rent refund"
},
{
"code": 6108,
"name": "localAttestationAlreadyConsumed",
"msg": "Local attestation has already been consumed"
},
{
"code": 6109,
"name": "executableRentRefundAccount",
"msg": "Rent refund recipient is still executable"
},
{
"code": 6110,
"name": "localAttestationNotConsumed",
"msg": "Local attestation has not been consumed"
}
],
"types": [
{
"name": "attestation",
"docs": [
"Type used to indicate that some data from another chain data has been attested.",
"It is derived from the attestation data as seeds"
],
"type": {
"kind": "struct",
"fields": [
{
"name": "bump",
"type": "u8"
}
]
}
},
{
"name": "attestationCreatedEvent",
"type": {
"kind": "struct",
"fields": [
{
"name": "attestator",
"type": "pubkey"
},
{
"name": "chainId",
"type": "u128"
},
{
"name": "source",
"type": {
"array": [
"u8",
32
]
}
},
{
"name": "application",
"type": {
"array": [
"u8",
32
]
}
},
{
"name": "payloadHash",
"type": {
"array": [
"u8",
32
]
}
}
]
}
},
{
"name": "chainId",
"docs": [
"Type used to store the chain id of the chain."
],
"type": {
"kind": "struct",
"fields": [
{
"name": "chainId",
"type": "u128"
},
{
"name": "bump",
"type": "u8"
}
]
}
},
{
"name": "chainIdConfiguredEvent",
"type": {
"kind": "struct",
"fields": [
{
"name": "chainIdAccountAddress",
"type": "pubkey"
},
{
"name": "chainId",
"type": "u128"
}
]
}
},
{
"name": "chainMapConfiguredEvent",
"type": {
"kind": "struct",
"fields": [
{
"name": "oracle",
"type": "pubkey"
},
{
"name": "protocolChainId",
"type": "u128"
},
{
"name": "chainId",
"type": "u128"
}
]
}
},
{
"name": "chainMapping",
"docs": [
"Type used to map a protocol chain identifier to a custom configured chain identifier."
],
"type": {
"kind": "struct",
"fields": [
{
"name": "chainId",
"type": "u128"
},
{
"name": "bump",
"type": "u8"
}
]
}
},
{
"name": "localAttestation",
"docs": [
"Type used to indicate that some data has been attested by an attestator.",
"It is derived from the local attestation data as seeds",
"`timestamp` is the timestamp of the local attestation was created at.",
"It is stored within the account since it cannot be known before creation.",
"`rent_refund` is the payer that funded the account; it receives the lamports",
"when consumed, or during deferred cleanup if that payer is executable."
],
"type": {
"kind": "struct",
"fields": [
{
"name": "timestamp",
"type": "u32"
},
{
"name": "bump",
"type": "u8"
},
{
"name": "rentRefund",
"type": "pubkey"
},
{
"name": "consumed",
"docs": [
"Consumed proofs retain their rent until cleanup when the payer is executable."
],
"type": "bool"
}
]
}
},
{
"name": "localAttestationConsumedEvent",
"type": {
"kind": "struct",
"fields": [
{
"name": "attestator",
"type": "pubkey"
},
{
"name": "consumer",
"type": {
"array": [
"u8",
32
]
}
},
{
"name": "dataHash",
"type": {
"array": [
"u8",
32
]
}
},
{
"name": "rentRefund",
"type": "pubkey"
}
]
}
},
{
"name": "localAttestationCreatedEvent",
"type": {
"kind": "struct",
"fields": [
{
"name": "attestator",
"type": "pubkey"
},
{
"name": "consumer",
"type": {
"array": [
"u8",
32
]
}
},
{
"name": "timestamp",
"type": "u32"
},
{
"name": "dataHash",
"type": {
"array": [
"u8",
32
]
}
}
]
}
},
{
"name": "localAttestationRentDeferredEvent",
"type": {
"kind": "struct",
"fields": [
{
"name": "localAttestation",
"type": "pubkey"
},
{
"name": "rentRefund",
"type": "pubkey"
}
]
}
},
{
"name": "localAttestationRentReclaimedEvent",
"type": {
"kind": "struct",
"fields": [
{
"name": "localAttestation",
"type": "pubkey"
},
{
"name": "rentRefund",
"type": "pubkey"
}
]
}
}
]
};
types/wormhole.ts
types/wormhole.ts
wormhole.ts
/** Generated by yarn idl:generate. Runtime IDL: ../wormhole.json. */
export type Wormhole = {
"address": "Fy28CqdB1WtDJLdc18fDGKqvpG8HxtSiSG5HChdhR4nU",
"metadata": {
"name": "wormhole",
"version": "0.0.0",
"spec": "0.1.0"
},
"instructions": [
{
"name": "initialize",
"docs": [
"Initializes the `oracle_wormhole` account. Creates `oracle_wormhole` PDA and sets the `core_bridge_id`.",
"`oracle_wormhole` PDA is used to store the chain identifier, the owner address, and the Wormhole core bridge program id."
],
"discriminator": [
175,
175,
109,
31,
13,
152,
155,
237
],
"accounts": [
{
"name": "deployer",
"writable": true,
"signer": true
},
{
"name": "chainId"
},
{
"name": "oracleWormhole",
"writable": true,
"pda": {
"seeds": [
{
"kind": "const",
"value": [
119,
111,
114,
109,
104,
111,
108,
101
]
}
]
}
},
{
"name": "intentsProtocolProgram",
"address": "LiFixdGLT5CMdLsHBvaijTXpPy4Uux9Y53SXkuR4HaK"
},
{
"name": "systemProgram",
"address": "11111111111111111111111111111111"
}
],
"args": [
{
"name": "coreBridgeId",
"type": "pubkey"
}
]
},
{
"name": "receive",
"docs": [
"Receive attestation proofs from a remote oracle and register them",
"locally by creating `attestation` accounts.",
"Remaining accounts: exactly one writable destination attestation PDA per decoded VAA payload, in decoded payload order. No remaining-account signers or refund slots; the named signer funds account creation.",
"Derive each address with the intents protocol program ID and seeds, in order: UTF-8 'attestation'; this program's oracle_wormhole state PDA (the attestator); the canonical chain ID as u128 little-endian, obtained by mapping the VAA emitter chain through the chain_mapping account (not the raw Wormhole chain ID); the 32-byte VAA emitter address (source); the 32-byte application from the decoded message; keccak256 of that payload."
],
"discriminator": [
86,
17,
255,
171,
17,
17,
187,
219
],
"accounts": [
{
"name": "signer",
"writable": true,
"signer": true
},
{
"name": "oracleWormhole",
"pda": {
"seeds": [
{
"kind": "const",
"value": [
119,
111,
114,
109,
104,
111,
108,
101
]
}
]
}
},
{
"name": "coreBridgeProgram"
},
{
"name": "postedVaa"
},
{
"name": "chainMapping"
},
{
"name": "intentsProtocolProgram",
"address": "LiFixdGLT5CMdLsHBvaijTXpPy4Uux9Y53SXkuR4HaK"
},
{
"name": "systemProgram",
"address": "11111111111111111111111111111111"
}
],
"args": []
},
{
"name": "setChainMapping",
"docs": [
"Maps wormhole chain id to a configured custom chain id.",
"Can only be called by the owner of the `oracle_wormhole` account.",
"Each mapping may only be set once."
],
"discriminator": [
174,
145,
44,
171,
203,
101,
230,
130
],
"accounts": [
{
"name": "signer",
"writable": true,
"signer": true
},
{
"name": "oracleWormhole",
"pda": {
"seeds": [
{
"kind": "const",
"value": [
119,
111,
114,
109,
104,
111,
108,
101
]
}
]
}
},
{
"name": "chainMapping",
"writable": true
},
{
"name": "intentsProtocolProgram",
"address": "LiFixdGLT5CMdLsHBvaijTXpPy4Uux9Y53SXkuR4HaK"
},
{
"name": "systemProgram",
"address": "11111111111111111111111111111111"
}
],
"args": [
{
"name": "protocolChainId",
"type": "u128"
},
{
"name": "chainId",
"type": "u128"
}
]
},
{
"name": "submit",
"docs": [
"Validates the proofs and posts a message via Wormhole.",
"Remaining accounts: exactly [local_attestation_0, rent_refund_0, ..., local_attestation_N-1, rent_refund_N-1] in fill_descriptions order. Payloads must not be empty. Both accounts in every pair must be writable; no additional remaining-account signers.",
"Each rent_refund must be the attestation's stored recipient. Executable recipients defer reclamation; keep both writable. The named submitter and fresh post_message account must sign; there is no additional filler-signature requirement."
],
"discriminator": [
88,
166,
102,
181,
162,
127,
170,
48
],
"accounts": [
{
"name": "submitter",
"writable": true,
"signer": true
},
{
"name": "oracleWormhole",
"pda": {
"seeds": [
{
"kind": "const",
"value": [
119,
111,
114,
109,
104,
111,
108,
101
]
}
]
}
},
{
"name": "postMessage",
"docs": [
"Fresh client-generated account that the Wormhole core bridge creates and",
"owns during the CPI. The core bridge requires the message account to sign,",
"so it is declared as a `Signer`. Using a unique account per submit (instead",
"of a shared, sequence-derived PDA) guarantees that independent or concurrent",
"submits can never collide on the same address."
],
"writable": true,
"signer": true
},
{
"name": "intentsProtocolProgram",
"address": "LiFixdGLT5CMdLsHBvaijTXpPy4Uux9Y53SXkuR4HaK"
},
{
"name": "coreBridgeProgram"
},
{
"name": "wormholeConfig",
"writable": true
},
{
"name": "wormholeSequence",
"writable": true
},
{
"name": "wormholeFeeCollector",
"writable": true
},
{
"name": "clock",
"address": "SysvarC1ock11111111111111111111111111111111"
},
{
"name": "rent",
"address": "SysvarRent111111111111111111111111111111111"
},
{
"name": "systemProgram",
"address": "11111111111111111111111111111111"
}
],
"args": [
{
"name": "source",
"type": "pubkey"
},
{
"name": "fillDescriptions",
"type": {
"vec": "bytes"
}
}
]
}
],
"accounts": [
{
"name": "chainId",
"discriminator": [
203,
146,
201,
161,
230,
71,
157,
218
]
},
{
"name": "chainMapping",
"discriminator": [
81,
78,
77,
209,
44,
206,
85,
169
]
},
{
"name": "oracleWormhole",
"discriminator": [
218,
207,
238,
190,
98,
163,
3,
199
]
}
],
"errors": [
{
"code": 6800,
"name": "wrongProgram",
"msg": "Wrong program"
},
{
"code": 6801,
"name": "invalidPostedVaa",
"msg": "Invalid posted VAA data"
},
{
"code": 6802,
"name": "invalidChainId",
"msg": "Invalid chain id"
},
{
"code": 6803,
"name": "unauthorized",
"msg": "Unauthorized mapping creation"
}
],
"types": [
{
"name": "chainId",
"docs": [
"Type used to store the chain id of the chain."
],
"type": {
"kind": "struct",
"fields": [
{
"name": "chainId",
"type": "u128"
},
{
"name": "bump",
"type": "u8"
}
]
}
},
{
"name": "chainMapping",
"docs": [
"Type used to map a protocol chain identifier to a custom configured chain identifier."
],
"type": {
"kind": "struct",
"fields": [
{
"name": "chainId",
"type": "u128"
},
{
"name": "bump",
"type": "u8"
}
]
}
},
{
"name": "oracleWormhole",
"docs": [
"Represents the `Wormhole` oracle implementation type.",
"Implements the `OracleBaseTrait`, `InputOracleBaseTrait` and `OutputOracleBaseTrait` traits.",
"`core_bridge_id` is the program id of the Wormhole core bridge program.",
"`owner` is the owner of the WormholeOracle. The only address to create mappings."
],
"type": {
"kind": "struct",
"fields": [
{
"name": "owner",
"type": "pubkey"
},
{
"name": "coreBridgeId",
"type": "pubkey"
},
{
"name": "chainId",
"type": "u128"
},
{
"name": "bump",
"type": "u8"
}
]
}
},
{
"name": "outputProvenEvent",
"docs": [
"IDL-only mirror of the event emitted by `oracle_base`.",
"",
"The event is emitted from inside `oracle_base` (see `base.rs`), but",
"Anchor's IDL generator only collects `#[event]` structs defined in the",
"program crate itself, so without this mirror the event is silently absent",
"from the published IDL. Anchor identifies an event by its name-derived",
"discriminator (`sha256(\"event:<Name>\")[..8]`) and its borsh field layout,",
"so an identical copy here yields the exact IDL entry for the event the",
"base crate emits. The test below pins the mirror to the base-crate",
"original byte-for-byte."
],
"type": {
"kind": "struct",
"fields": [
{
"name": "chainId",
"type": "u128"
},
{
"name": "remoteIdentifier",
"type": {
"array": [
"u8",
32
]
}
},
{
"name": "application",
"type": {
"array": [
"u8",
32
]
}
},
{
"name": "payloadHash",
"type": {
"array": [
"u8",
32
]
}
}
]
}
}
],
"events": [
{
"name": "outputProvenEvent",
"discriminator": [
85,
190,
185,
8,
90,
48,
3,
214
]
}
]
};
后续步骤
Solana 程序
每个程序的职责及其账户模型
在 Solana 上调试
解读失败的交易和错误码