@projectsolo/solo-mission-mcp 0.21.13 → 0.22.0

package/src/solana/fixtures/solo_escrow.v2.idl-excerpt.json

@@ -0,0 +1,683 @@
+{
+  "_source": "ProjectSoloAI/solo-escrow-solana u1.1.0 (main 4376bace61797a1edebc8d001f74e6a1f1c7bac4) idl/solo_escrow.json, trimmed with jq to the parts the MCP verifier depends on",
+  "address": "2CPC5V63FDs7SdWu89iSYYsTEpqBwuQeYuA9ASzuSo8a",
+  "metadata": {
+    "name": "solo_escrow",
+    "version": "0.0.0",
+    "spec": "0.1.0",
+    "description": "Anchor port of EscrowVault.sol"
+  },
+  "instructions": [
+    {
+      "name": "cancel_task",
+      "docs": [
+        "`R-E5`, `R-H3`, `R-J1`, `R-A5`, `R-K1`, `R-K4`, SE-07(a).",
+        "",
+        "Cancellation before qualification returns the **full** budget with no fee (`R-H3`). Sponsor",
+        "authority is checked against the stored `task.sponsor`, never a caller-supplied field.",
+        "It closes at the qualification deadline: after that the participants' work is done, and a",
+        "sponsor must not be able to front-run the Operator's finalize to walk away with it."
+      ],
+      "discriminator": [
+        69,
+        228,
+        134,
+        187,
+        134,
+        105,
+        238,
+        48
+      ],
+      "accounts": [
+        {
+          "name": "sponsor",
+          "signer": true
+        },
+        {
+          "name": "config",
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  99,
+                  111,
+                  110,
+                  102,
+                  105,
+                  103
+                ]
+              }
+            ]
+          }
+        },
+        {
+          "name": "task",
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  116,
+                  97,
+                  115,
+                  107
+                ]
+              },
+              {
+                "kind": "account",
+                "path": "task.task_id",
+                "account": "Task"
+              }
+            ]
+          }
+        },
+        {
+          "name": "vault",
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  118,
+                  97,
+                  117,
+                  108,
+                  116
+                ]
+              },
+              {
+                "kind": "account",
+                "path": "task.task_id",
+                "account": "Task"
+              }
+            ]
+          }
+        },
+        {
+          "name": "sponsor_token_account",
+          "docs": [
+            "`R-K4` — non-default recipient, and it must belong to the stored sponsor."
+          ],
+          "writable": true
+        },
+        {
+          "name": "token_program",
+          "address": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
+        },
+        {
+          "name": "event_authority"
+        },
+        {
+          "name": "program"
+        }
+      ],
+      "args": []
+    },
+    {
+      "name": "claim_refund",
+      "docs": [
+        "`R-J3`, `R-A5`, `R-K1`, `R-K4`. Exactly the refundable amount, exactly once, to a non-zero",
+        "recipient owned by the stored sponsor."
+      ],
+      "discriminator": [
+        15,
+        16,
+        30,
+        161,
+        255,
+        228,
+        97,
+        60
+      ],
+      "accounts": [
+        {
+          "name": "sponsor",
+          "signer": true
+        },
+        {
+          "name": "config",
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  99,
+                  111,
+                  110,
+                  102,
+                  105,
+                  103
+                ]
+              }
+            ]
+          }
+        },
+        {
+          "name": "task",
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  116,
+                  97,
+                  115,
+                  107
+                ]
+              },
+              {
+                "kind": "account",
+                "path": "task.task_id",
+                "account": "Task"
+              }
+            ]
+          }
+        },
+        {
+          "name": "vault",
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  118,
+                  97,
+                  117,
+                  108,
+                  116
+                ]
+              },
+              {
+                "kind": "account",
+                "path": "task.task_id",
+                "account": "Task"
+              }
+            ]
+          }
+        },
+        {
+          "name": "sponsor_token_account",
+          "docs": [
+            "`R-K4` — non-default recipient, and it must belong to the stored sponsor."
+          ],
+          "writable": true
+        },
+        {
+          "name": "token_program",
+          "address": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
+        },
+        {
+          "name": "event_authority"
+        },
+        {
+          "name": "program"
+        }
+      ],
+      "args": []
+    },
+    {
+      "name": "create_task",
+      "docs": [
+        "`R-B3`, `R-C1`, `R-C2`, `R-D1`, `R-E1`, `R-E2`, `R-G1`, `R-H1`, `R-K1`, `R-K5`, SE-02,",
+        "SE-07, N-2, N-3, N-4.",
+        "",
+        "The sponsor escrows the entire budget here; no obligation exists before the funds land",
+        "(`R-C1`). The sponsor also funds the Task and vault rent and is recorded as the",
+        "`rent_refund_recipient` — freeze §09, and Winston's review §1 on why that must be stored",
+        "rather than supplied at close.",
+        "",
+        "Non-lottery creation stays permissionless. A lottery task (`lottery_winner_count > 0`) must",
+        "be co-signed by the configured Operator, which binds its seed commitment to the platform",
+        "that has to reveal it (SE-02)."
+      ],
+      "discriminator": [
+        194,
+        80,
+        6,
+        180,
+        232,
+        127,
+        48,
+        171
+      ],
+      "accounts": [
+        {
+          "name": "sponsor",
+          "writable": true,
+          "signer": true
+        },
+        {
+          "name": "config",
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  99,
+                  111,
+                  110,
+                  102,
+                  105,
+                  103
+                ]
+              }
+            ]
+          }
+        },
+        {
+          "name": "whitelist",
+          "docs": [
+            "`R-C4` — the whitelist gates creation. Requiring the account here is exactly the gate; no",
+            "downstream instruction may require it."
+          ],
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  119,
+                  104,
+                  105,
+                  116,
+                  101,
+                  108,
+                  105,
+                  115,
+                  116
+                ]
+              },
+              {
+                "kind": "account",
+                "path": "mint"
+              }
+            ]
+          }
+        },
+        {
+          "name": "mint"
+        },
+        {
+          "name": "task",
+          "docs": [
+            "Seeded by the counter, so `R-B3` holds without consulting an archive."
+          ],
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  116,
+                  97,
+                  115,
+                  107
+                ]
+              },
+              {
+                "kind": "account",
+                "path": "config.task_counter",
+                "account": "Config"
+              }
+            ]
+          }
+        },
+        {
+          "name": "vault",
+          "docs": [
+            "Per-task escrow custody. Authority is the Task PDA, so no key can move it (`R-K3`).",
+            "Closed by `close_task` and its rent returned to `task.rent_refund_recipient` (freeze §08)."
+          ],
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  118,
+                  97,
+                  117,
+                  108,
+                  116
+                ]
+              },
+              {
+                "kind": "account",
+                "path": "config.task_counter",
+                "account": "Config"
+              }
+            ]
+          }
+        },
+        {
+          "name": "sponsor_token_account",
+          "writable": true
+        },
+        {
+          "name": "token_program",
+          "address": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
+        },
+        {
+          "name": "system_program",
+          "address": "11111111111111111111111111111111"
+        },
+        {
+          "name": "operator",
+          "docs": [
+            "SE-02 — required, and must be `Config.operator`, when `lottery_winner_count > 0`; ignored",
+            "otherwise. Pass the program id (Anchor's `None` sentinel) to omit it."
+          ],
+          "signer": true,
+          "optional": true
+        },
+        {
+          "name": "event_authority"
+        },
+        {
+          "name": "program"
+        }
+      ],
+      "args": [
+        {
+          "name": "budget",
+          "type": "u64"
+        },
+        {
+          "name": "base_pool",
+          "type": "u64"
+        },
+        {
+          "name": "lottery_winner_count",
+          "type": "u32"
+        },
+        {
+          "name": "lottery_prize_per_winner",
+          "type": "u64"
+        },
+        {
+          "name": "qualify_deadline",
+          "type": "i64"
+        },
+        {
+          "name": "settlement_deadline",
+          "type": "i64"
+        },
+        {
+          "name": "seed_commit",
+          "type": {
+            "array": [
+              "u8",
+              32
+            ]
+          }
+        },
+        {
+          "name": "max_fee_bps",
+          "type": "u16"
+        }
+      ]
+    },
+    {
+      "name": "emergency_refund",
+      "docs": [
+        "`R-E6`, `R-H3`, `R-J2`. Reachable from `Funded` or `Qualified`, only strictly after the",
+        "settlement deadline — so a stalled operator, or a silent randomness oracle, can never trap",
+        "the budget. Freeze §07 leans on this as the escape hatch for the oracle dependency."
+      ],
+      "discriminator": [
+        188,
+        73,
+        52,
+        195,
+        137,
+        70,
+        180,
+        147
+      ],
+      "accounts": [
+        {
+          "name": "sponsor",
+          "signer": true
+        },
+        {
+          "name": "config",
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  99,
+                  111,
+                  110,
+                  102,
+                  105,
+                  103
+                ]
+              }
+            ]
+          }
+        },
+        {
+          "name": "task",
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  116,
+                  97,
+                  115,
+                  107
+                ]
+              },
+              {
+                "kind": "account",
+                "path": "task.task_id",
+                "account": "Task"
+              }
+            ]
+          }
+        },
+        {
+          "name": "vault",
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  118,
+                  97,
+                  117,
+                  108,
+                  116
+                ]
+              },
+              {
+                "kind": "account",
+                "path": "task.task_id",
+                "account": "Task"
+              }
+            ]
+          }
+        },
+        {
+          "name": "sponsor_token_account",
+          "docs": [
+            "`R-K4` — non-default recipient, and it must belong to the stored sponsor."
+          ],
+          "writable": true
+        },
+        {
+          "name": "token_program",
+          "address": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
+        },
+        {
+          "name": "event_authority"
+        },
+        {
+          "name": "program"
+        }
+      ],
+      "args": []
+    }
+  ],
+  "accounts": [
+    {
+      "name": "Config",
+      "discriminator": [
+        155,
+        12,
+        170,
+        224,
+        30,
+        250,
+        204,
+        130
+      ]
+    }
+  ],
+  "types": [
+    {
+      "name": "Config",
+      "docs": [
+        "Singleton. Seeds: `[\"config\"]`.",
+        "",
+        "Replaces the reference's role registry, fee rate, treasury, pause flag and review window.",
+        "Satisfies `R-A1`–`R-A8`, `R-H1`–`R-H2`, `R-I4`."
+      ],
+      "type": {
+        "kind": "struct",
+        "fields": [
+          {
+            "name": "admin",
+            "type": "pubkey"
+          },
+          {
+            "name": "operator",
+            "type": "pubkey"
+          },
+          {
+            "name": "guardian",
+            "type": "pubkey"
+          },
+          {
+            "name": "treasury",
+            "type": "pubkey"
+          },
+          {
+            "name": "fee_bps",
+            "docs": [
+              "Fee applied to tasks created from now on. `R-H1` freezes it per task at creation."
+            ],
+            "type": "u16"
+          },
+          {
+            "name": "min_review_window",
+            "docs": [
+              "Configurable minimum review window, itself floored by `MIN_REVIEW_WINDOW_FLOOR` (`R-I4`)."
+            ],
+            "type": "i64"
+          },
+          {
+            "name": "paused",
+            "docs": [
+              "`R-K1`. Guardian sets, Admin clears (`R-A8`)."
+            ],
+            "type": "bool"
+          },
+          {
+            "name": "task_counter",
+            "docs": [
+              "Monotonic source of `task_id`. Freeze §08 — makes `R-B3`'s forever-uniqueness structural,",
+              "so no tombstone lookup is needed at creation and the Task PDA can be archived rather than",
+              "consulted."
+            ],
+            "type": "u64"
+          },
+          {
+            "name": "bump",
+            "type": "u8"
+          },
+          {
+            "name": "pending_role",
+            "docs": [
+              "SE-08 — the single pending role change, taken from `CONFIG_RESERVE`. None is pending",
+              "while `pending_incoming` is the default key (`R-A7` forbids proposing it), so a legacy",
+              "account's zeroed reserve reads as \"nothing pending\" and fails safe (N-7)."
+            ],
+            "type": {
+              "defined": {
+                "name": "Role"
+              }
+            }
+          },
+          {
+            "name": "pending_incoming",
+            "type": "pubkey"
+          },
+          {
+            "name": "pending_effective_at",
+            "docs": [
+              "Earliest `unix_timestamp` at which `pending_incoming` may accept."
+            ],
+            "type": "i64"
+          }
+        ]
+      }
+    }
+  ],
+  "errors": [
+    {
+      "code": 6012,
+      "name": "SettlementWindowTooShort",
+      "msg": "R-E2: settlement deadline does not leave the minimum window"
+    },
+    {
+      "code": 6016,
+      "name": "TooEarlyForEmergencyRefund",
+      "msg": "R-E6: emergency refund requires the settlement deadline to have passed"
+    },
+    {
+      "code": 6026,
+      "name": "RefundAlreadyClaimed",
+      "msg": "R-J3: the refundable amount has already been claimed"
+    },
+    {
+      "code": 6027,
+      "name": "NothingToRefund",
+      "msg": "R-J3: there is nothing to refund"
+    },
+    {
+      "code": 6124,
+      "name": "LotteryRequiresOperator",
+      "msg": "SE-02: a lottery task must be co-signed by the configured Operator"
+    },
+    {
+      "code": 6125,
+      "name": "TooLateToCancel",
+      "msg": "SE-07: cancellation closes at the qualification deadline"
+    },
+    {
+      "code": 6132,
+      "name": "FeeAboveSponsorMax",
+      "msg": "N-2: the current fee rate exceeds the sponsor's maximum"
+    },
+    {
+      "code": 6133,
+      "name": "QualifyDeadlineTooFar",
+      "msg": "N-3: qualification deadline is beyond the maximum horizon"
+    },
+    {
+      "code": 6134,
+      "name": "SettlementDeadlineTooFar",
+      "msg": "N-3: settlement deadline is beyond the maximum settlement window"
+    }
+  ]
+}