From d9f4b266a20419c991a1f8d0fcf715a9c71a4b41 Mon Sep 17 00:00:00 2001 From: dkijania Date: Fri, 2 Oct 2026 20:51:15 +0200 Subject: [PATCH] Update spec/ to mina-sdk-spec v0.1.2 The Python column in SPEC.md and ITN.md, the custom-query method names, and an absolute link to the ITN schema. The operations do not change. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01E9VzXg2bJYonrX5xBfmLMr --- CHANGELOG.md | 3 +-- spec/ITN.md | 24 ++++++++++++------------ spec/VERSION | 2 +- 3 files changed, 14 insertions(+), 15 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 7929ab1..268658a 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -9,7 +9,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 ### Added - The common API of the Mina SDKs, from - [mina-sdk-spec](https://github.com/o1-labs/mina-sdk-spec) v0.1.0: `spec/` + [mina-sdk-spec](https://github.com/o1-labs/mina-sdk-spec) v0.1.2: `spec/` is a copy at the tag in `spec/VERSION`. `tests/test_spec.py` checks that the query strings are the specification's documents, and a CI job checks that `spec/` is the tag's copy. @@ -33,7 +33,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 numbers (one request at a time, a new auth after HTTP 412) and no repeat after a transport error. It covers every operation of `spec/itn-operations.graphql`, as the Rust, Go and JS SDKs do. -- `spec/` is mina-sdk-spec v0.1.1. - Integration tests of the new methods. - `DaemonConnectionError` exception (replaces shadowed `ConnectionError`) - `Currency.__rmul__` for `3 * Currency(10)` support diff --git a/spec/ITN.md b/spec/ITN.md index 99df212..0d6c459 100644 --- a/spec/ITN.md +++ b/spec/ITN.md @@ -7,8 +7,8 @@ ITN server (schema `Mina_graphql.schema_itn`, see schedule payments and zkApp commands, read internal logs, change connection gating and stop the daemon. -The Rust, Go and JS SDKs have the same ITN client; `mina-sdk-python` has no -ITN client yet (– in the Python column). This document and +The Mina SDKs have the same ITN client (Python: `mina_sdk.itn`, with the +extra `mina-sdk[itn]`). This document and [`itn-operations.graphql`](itn-operations.graphql) define it. The rules of [`SPEC.md`](SPEC.md) apply: each method sends one named operation, and nullable variables are always sent, as null when the caller omits them. @@ -46,16 +46,16 @@ A client must: | Operation | Rust | Go | JS | Python | Arguments | Returns | |:--|:--|:--|:--|:--|:--|:--| -| `Auth` | `auth` | `Auth` | `auth` | – | – | server UUID, sequence number, libp2p port, peer ID, block producer flag | -| `SlotsWon` | `slots_won` | `SlotsWon` | `slotsWon` | – | – | list of global slots | -| `InternalLogs` | `internal_logs` | `InternalLogs` | `internalLogs` | – | start log ID | list of logs (`id`, `timestamp`, `message`, `metadata` (`item`, `value`), `process?`) | -| `FlushInternalLogs` | `flush_internal_logs` | `FlushInternalLogs` | `flushInternalLogs` | – | end log ID | string | -| `SchedulePayments` | `schedule_payments` | `SchedulePayments` | `schedulePayments` | – | `PaymentsDetails` | handle | -| `ScheduleZkappCommands` | `schedule_zkapp_commands` | `ScheduleZkappCommands` | `scheduleZkappCommands` | – | `ZkappCommandsDetails` | handle | -| `StopScheduledTransactions` | `stop_scheduled_transactions` | `StopScheduledTransactions` | `stopScheduledTransactions` | – | handle | string | -| `UpdateGating` | `update_gating` | `UpdateGating` | `updateGating` | – | `GatingUpdate` | string | -| `StopDaemon` | `stop_daemon` | `StopDaemon` | `stopDaemon` | – | [delay seconds], [clean config] | string | -| `ZkappCommandLimit` | `set_zkapp_command_limit` | `SetZkappCommandLimit` | `setZkappCommandLimit` | – | limit or null | limit now in force | +| `Auth` | `auth` | `Auth` | `auth` | `auth` | – | server UUID, sequence number, libp2p port, peer ID, block producer flag | +| `SlotsWon` | `slots_won` | `SlotsWon` | `slotsWon` | `slots_won` | – | list of global slots | +| `InternalLogs` | `internal_logs` | `InternalLogs` | `internalLogs` | `internal_logs` | start log ID | list of logs (`id`, `timestamp`, `message`, `metadata` (`item`, `value`), `process?`) | +| `FlushInternalLogs` | `flush_internal_logs` | `FlushInternalLogs` | `flushInternalLogs` | `flush_internal_logs` | end log ID | string | +| `SchedulePayments` | `schedule_payments` | `SchedulePayments` | `schedulePayments` | `schedule_payments` | `PaymentsDetails` | handle | +| `ScheduleZkappCommands` | `schedule_zkapp_commands` | `ScheduleZkappCommands` | `scheduleZkappCommands` | `schedule_zkapp_commands` | `ZkappCommandsDetails` | handle | +| `StopScheduledTransactions` | `stop_scheduled_transactions` | `StopScheduledTransactions` | `stopScheduledTransactions` | `stop_scheduled_transactions` | handle | string | +| `UpdateGating` | `update_gating` | `UpdateGating` | `updateGating` | `update_gating` | `GatingUpdate` | string | +| `StopDaemon` | `stop_daemon` | `StopDaemon` | `stopDaemon` | `stop_daemon` | [delay seconds], [clean config] | string | +| `ZkappCommandLimit` | `set_zkapp_command_limit` | `SetZkappCommandLimit` | `setZkappCommandLimit` | `set_zkapp_command_limit` | limit or null | limit now in force | The input types `PaymentsDetails`, `ZkappCommandsDetails` and `GatingUpdate` have the fields of [`schema/itn.graphql`](https://github.com/o1-labs/mina-sdk-spec/blob/main/schema/itn.graphql). Every SDK also diff --git a/spec/VERSION b/spec/VERSION index 8308b63..5366600 100644 --- a/spec/VERSION +++ b/spec/VERSION @@ -1 +1 @@ -v0.1.1 +v0.1.2