diff --git a/.github/workflows/update-version-dashboard.yml b/.github/workflows/update-version-dashboard.yml index 4e50007ca..133587813 100644 --- a/.github/workflows/update-version-dashboard.yml +++ b/.github/workflows/update-version-dashboard.yml @@ -23,8 +23,14 @@ jobs: - name: Set up Nix uses: cachix/install-nix-action@v31 - - name: Update version dashboard - run: nix-shell --run 'npm run generate:version-compatibility-dashboard' + - name: Update version dashboard and Wallet Gateway OpenRPC + env: + GH_TOKEN: ${{ github.token }} + GITHUB_TOKEN: ${{ github.token }} + run: | + nix-shell --run 'npm run generate:version-compatibility-dashboard' + nix-shell --run 'npm run update:generated-reference-sources -- --source wallet-gateway-openrpc' + nix-shell --run 'npm run generate:wallet-gateway-openrpc-reference' - name: Detect changes id: changes @@ -45,8 +51,9 @@ jobs: if: steps.changes.outputs.has_changes == 'true' env: GH_TOKEN: ${{ github.token }} + PR_BASE_BRANCH: ${{ github.ref_name }} PR_BRANCH: version-dashboard/update - PR_TITLE: Update version dashboard data + PR_TITLE: Update version dashboard and generated references run: | set -euo pipefail @@ -54,7 +61,12 @@ jobs: git config user.email "41898282+github-actions[bot]@users.noreply.github.com" git switch -c "$PR_BRANCH" - git add config/repo-version-config.json docs-main/snippets/generated/version-dashboard-data.mdx + git add \ + config/repo-version-config.json \ + config/x2mdx/wallet-gateway-openrpc/source-artifacts.json \ + docs-main/docs.json \ + docs-main/reference/wallet-gateway-json-rpc \ + docs-main/snippets/generated/version-dashboard-data.mdx git commit -m "$PR_TITLE" if remote_sha="$(git ls-remote --heads origin "$PR_BRANCH" | awk '{print $1}')" && [[ -n "$remote_sha" ]]; then @@ -67,8 +79,12 @@ jobs: cat > "$pr_body" <<'EOF' Updates the committed Canton Network version dashboard data from public network, package, and installer sources. + Also updates the Wallet Gateway OpenRPC source pin to the latest stable wallet-gateway-remote release and regenerates the checked-in Wallet Gateway OpenRPC reference pages. + Validation run by the workflow: - `npm run generate:version-compatibility-dashboard` + - `npm run update:generated-reference-sources -- --source wallet-gateway-openrpc` + - `npm run generate:wallet-gateway-openrpc-reference` - `git diff --check` EOF @@ -76,7 +92,7 @@ jobs: gh pr list \ --repo "$GITHUB_REPOSITORY" \ --head "$PR_BRANCH" \ - --base main \ + --base "$PR_BASE_BRANCH" \ --state open \ --json number \ --jq '.[0].number // empty' @@ -87,11 +103,15 @@ jobs: --repo "$GITHUB_REPOSITORY" \ --title "$PR_TITLE" \ --body-file "$pr_body" + gh pr ready "$existing_pr_number" \ + --repo "$GITHUB_REPOSITORY" \ + --undo else gh pr create \ - --base main \ + --base "$PR_BASE_BRANCH" \ --head "$PR_BRANCH" \ --repo "$GITHUB_REPOSITORY" \ + --draft \ --title "$PR_TITLE" \ --body-file "$pr_body" fi diff --git a/config/x2mdx/wallet-gateway-openrpc/source-artifacts.json b/config/x2mdx/wallet-gateway-openrpc/source-artifacts.json index bafd8ccc0..325d463b3 100644 --- a/config/x2mdx/wallet-gateway-openrpc/source-artifacts.json +++ b/config/x2mdx/wallet-gateway-openrpc/source-artifacts.json @@ -4,7 +4,7 @@ "remote": "https://github.com/hyperledger-labs/splice-wallet-kernel.git", "tag_prefix": "@canton-network/wallet-gateway-remote@", "min_version": "0.24.0", - "publish_version": "0.25.0", + "publish_version": "1.4.0", "specs": [ { "spec_id": "dapp-api", diff --git a/docs-main/docs.json b/docs-main/docs.json index cd3e0c2c8..84c9ca1de 100644 --- a/docs-main/docs.json +++ b/docs-main/docs.json @@ -1499,8 +1499,10 @@ "reference/wallet-gateway-json-rpc/operations/dapp-api/disconnect", "reference/wallet-gateway-json-rpc/operations/dapp-api/getactivenetwork", "reference/wallet-gateway-json-rpc/operations/dapp-api/getprimaryaccount", + "reference/wallet-gateway-json-rpc/operations/dapp-api/isconnected", "reference/wallet-gateway-json-rpc/operations/dapp-api/ledgerapi", "reference/wallet-gateway-json-rpc/operations/dapp-api/listaccounts", + "reference/wallet-gateway-json-rpc/operations/dapp-api/messagesignature", "reference/wallet-gateway-json-rpc/operations/dapp-api/prepareexecute", "reference/wallet-gateway-json-rpc/operations/dapp-api/prepareexecuteandwait", "reference/wallet-gateway-json-rpc/operations/dapp-api/signmessage", @@ -1518,8 +1520,10 @@ "reference/wallet-gateway-json-rpc/operations/dapp-remote-api/disconnect", "reference/wallet-gateway-json-rpc/operations/dapp-remote-api/getactivenetwork", "reference/wallet-gateway-json-rpc/operations/dapp-remote-api/getprimaryaccount", + "reference/wallet-gateway-json-rpc/operations/dapp-remote-api/isconnected", "reference/wallet-gateway-json-rpc/operations/dapp-remote-api/ledgerapi", "reference/wallet-gateway-json-rpc/operations/dapp-remote-api/listaccounts", + "reference/wallet-gateway-json-rpc/operations/dapp-remote-api/messagesignature", "reference/wallet-gateway-json-rpc/operations/dapp-remote-api/onstatuschanged", "reference/wallet-gateway-json-rpc/operations/dapp-remote-api/prepareexecute", "reference/wallet-gateway-json-rpc/operations/dapp-remote-api/signmessage", @@ -1541,12 +1545,16 @@ "reference/wallet-gateway-json-rpc/operations/user-api/addsession", "reference/wallet-gateway-json-rpc/operations/user-api/allocatepartyforwallet", "reference/wallet-gateway-json-rpc/operations/user-api/createwallet", + "reference/wallet-gateway-json-rpc/operations/user-api/deletemessagetosign", "reference/wallet-gateway-json-rpc/operations/user-api/deletetransaction", "reference/wallet-gateway-json-rpc/operations/user-api/execute", + "reference/wallet-gateway-json-rpc/operations/user-api/getmessagetosign", + "reference/wallet-gateway-json-rpc/operations/user-api/getnetwork", "reference/wallet-gateway-json-rpc/operations/user-api/gettransaction", "reference/wallet-gateway-json-rpc/operations/user-api/getuser", "reference/wallet-gateway-json-rpc/operations/user-api/iswalletsyncneeded", "reference/wallet-gateway-json-rpc/operations/user-api/listidps", + "reference/wallet-gateway-json-rpc/operations/user-api/listmessagestosign", "reference/wallet-gateway-json-rpc/operations/user-api/listnetworks", "reference/wallet-gateway-json-rpc/operations/user-api/listsessions", "reference/wallet-gateway-json-rpc/operations/user-api/listtransactions", @@ -1555,8 +1563,10 @@ "reference/wallet-gateway-json-rpc/operations/user-api/removenetwork", "reference/wallet-gateway-json-rpc/operations/user-api/removesession", "reference/wallet-gateway-json-rpc/operations/user-api/removewallet", + "reference/wallet-gateway-json-rpc/operations/user-api/selfsignedaccesstoken", "reference/wallet-gateway-json-rpc/operations/user-api/setprimarywallet", "reference/wallet-gateway-json-rpc/operations/user-api/sign", + "reference/wallet-gateway-json-rpc/operations/user-api/signmessage", "reference/wallet-gateway-json-rpc/operations/user-api/syncwallets", "reference/wallet-gateway-json-rpc/operations/user-api/details" ] @@ -1570,6 +1580,7 @@ "reference/wallet-gateway-json-rpc/operations/signing-api/gettransaction", "reference/wallet-gateway-json-rpc/operations/signing-api/gettransactions", "reference/wallet-gateway-json-rpc/operations/signing-api/setconfiguration", + "reference/wallet-gateway-json-rpc/operations/signing-api/signmessage", "reference/wallet-gateway-json-rpc/operations/signing-api/signtransaction", "reference/wallet-gateway-json-rpc/operations/signing-api/subscribetransactions", "reference/wallet-gateway-json-rpc/operations/signing-api/details" diff --git a/docs-main/reference/wallet-gateway-json-rpc/index.mdx b/docs-main/reference/wallet-gateway-json-rpc/index.mdx index 6da44fddf..86dd2810e 100644 --- a/docs-main/reference/wallet-gateway-json-rpc/index.mdx +++ b/docs-main/reference/wallet-gateway-json-rpc/index.mdx @@ -4,47 +4,47 @@ description: "Versioned OpenRPC reference docs." ---
- +

OpenRPC Reference

- - + +

Wallet Gateway

- - + +

Operation-first JSON-RPC reference pages with version history carried from the snapshot lifecycle report.

- - + +
- + OpenRPC - - 0.25.0 - + + 1.4.0 +
- +
- +
Publish version
-
0.25.0
+
1.4.0
- +
Versions compared
-
0.24.0, 0.25.0
+
0.24.0, 0.25.0, 0.26.0, 0.27.0, 1.1.0, 1.2.0, 1.2.1, 1.3.0, 1.4.0
- +
Source
-
Wallet Gateway OpenRPC specs from wallet-gateway-remote releases
+
splice-wallet-kernel Wallet Gateway OpenRPC specs from wallet-gateway-remote releases
- +
Version filter
@canton-network/wallet-gateway-remote@ GitHub releases
- +
@@ -58,173 +58,179 @@ Choose a spec page to browse its methods, then drill into operation pages for re
- - + + - +

Sync dApp API

- +
- + JSON-RPC - + Since 0.24.0 - + + Changed 1.4.0 +
- +

An OpenRPC specification for the dapp to interact with a Wallet Provider.

- - + +
- +
Methods
-
12
+
14
- +
Latest version
-
0.25.0
+
1.4.0
- +
OpenRPC
1.2.6
- +
- +
- - - + + + - +

Async dApp API

- +
- + JSON-RPC - + Since 0.24.0 - + + Changed 1.4.0 +
- +

An OpenRPC specification for remotely hosted Wallet Providers. Due to the remote nature, an implementing provider must bridge certain functionality on the client-side to satisfy the general dApp AP...

- - + +
- +
Methods
-
13
+
15
- +
Latest version
-
0.25.0
+
1.4.0
- +
OpenRPC
1.2.6
- +
- +
- - - + + + - +

Signing API

- +
- + JSON-RPC - + Since 0.24.0 - +
- +

An OpenRPC specification for the Signing API which allows the Wallet Gateway to interact with a Wallet Providers.

- - + +
- +
Methods
-
8
+
9
- +
Latest version
-
0.25.0
+
1.4.0
- +
OpenRPC
1.2.6
- +
- +
- - - + + + - +

User API

- +
- + JSON-RPC - + Since 0.24.0 - + + Changed 1.4.0 +
- +

An OpenRPC specification for the user to interact with the Wallet Gateway.

- - + +
- +
Methods
-
22
+
28
- +
Latest version
-
0.25.0
+
1.4.0
- +
OpenRPC
1.2.6
- +
- +
- - + +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-api/accountschanged.mdx b/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-api/accountschanged.mdx index c3d27b0d3..d460e6394 100644 --- a/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-api/accountschanged.mdx +++ b/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-api/accountschanged.mdx @@ -9,53 +9,53 @@ title: "accountsChanged"
- +

Sync dApp API

- - + +

accountsChanged

- - - + + +
- + JSON-RPC - + Since 0.24.0 - +
- +
- + POST - + JSON-RPC accountsChanged
@@ -63,32 +63,32 @@ title: "accountsChanged"
- +
Protocol
JSON-RPC
- +
Transport
HTTP POST
- +
Method
accountsChanged
- +
Parameters
0
- +
Result
array[object]
- +
@@ -102,47 +102,47 @@ title: "accountsChanged"

result

- +
- - - + + +
- +
Shape
array[object]
- +
Schema
AccountsChangedEvent
- +
- - - + + +
- +
items object - + required - +
- +
- +
- - - - + + + +
@@ -157,25 +157,25 @@ title: "accountsChanged"
- - + +
- +
items object - + required - +
- +
- +
- - + +
@@ -185,12 +185,12 @@ title: "accountsChanged"
- +
cURL - +
```bash cURL @@ -208,14 +208,14 @@ EOF
- +
Result - + application/json - +
```json Result @@ -235,7 +235,7 @@ EOF
- +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-api/connect.mdx b/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-api/connect.mdx index bea645d3c..f1f178b04 100644 --- a/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-api/connect.mdx +++ b/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-api/connect.mdx @@ -9,53 +9,53 @@ title: "connect"
- +

Sync dApp API

- - + +

connect

- - - + + +
- + JSON-RPC - + Since 0.24.0 - +
- +
- + POST - + JSON-RPC connect
@@ -63,32 +63,32 @@ title: "connect"
- +
Protocol
JSON-RPC
- +
Transport
HTTP POST
- +
Method
connect
- +
Parameters
0
- +
Result
object
- +
@@ -102,63 +102,63 @@ title: "connect"

result

- +
- - - + + +
- +
Shape
object
- +
Schema
ConnectResult
- +
Required
isConnected, isNetworkConnected
- +
- - - + + +
- +
isConnected string - + required - +
- +
- +
isNetworkConnected string - + required - +
- +
- +
- - - - + + + +
@@ -173,36 +173,36 @@ title: "connect"
- - + +
- +
isConnected string - + required - +
- +
- +
isNetworkConnected string - + required - +
- +
- +
- - + +
@@ -212,12 +212,12 @@ title: "connect"
- +
cURL - +
```bash cURL @@ -235,14 +235,14 @@ EOF
- +
Result - + application/json - +
```json Result @@ -254,7 +254,7 @@ EOF
- +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-api/details.mdx b/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-api/details.mdx index f7cb29809..24af966c8 100644 --- a/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-api/details.mdx +++ b/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-api/details.mdx @@ -1,55 +1,54 @@ --- title: "Details and history" +description: "An OpenRPC specification for the dapp to interact with a Wallet Provider." --- -
+

Back to overview

-
-
+
+

OpenRPC Spec

-
- -

openrpc spec

- -

Sync dApp API

-

Details and history

-

An OpenRPC specification for the dapp to interact with a Wallet Provider.

- -
- - JSON-RPC - - Since 0.24.0 - -
-
-
+

Sync dApp API

+ + +

An OpenRPC specification for the dapp to interact with a Wallet Provider.

+ + +
+ + JSON-RPC + + Since 0.24.0 + + Changed 1.4.0 + +
+ -
- +
Latest source path
api-specs/openrpc-dapp-api.json
- +
Publish version
-
0.25.0
+
1.4.0
- +
OpenRPC version
1.2.6
- +
Spec info.version
0.5.0
- +
@@ -63,445 +62,521 @@ Method pages are the primary reference surface. This spec page stays focused on
- - + + - +

accountsChanged

- +
- + JSON-RPC - + Since 0.24.0 - +
- - + +
- +
Parameters
0
- +
Result
array[object]
- +
- +
- - - + + + - +

connect

- +
- + JSON-RPC - + Since 0.24.0 - +
- +

Ensures ledger connectivity and returns the connected network information along with the session information.

- - + +
- +
Parameters
0
- +
Result
object
- +
- +
- - - + + + - +

disconnect

- +
- + JSON-RPC - + Since 0.24.0 - +
- +

Invoke a disconnect of the wallet provider session.

- - + +
- +
Parameters
0
- +
Result
null
- +
- +
- - - + + + - +

getActiveNetwork

- +
- + JSON-RPC - + Since 0.24.0 - +
- +

Returns the active network.

- - + +
- +
Parameters
0
- +
Result
object
- +
- +
- - - + + + - +

getPrimaryAccount

- +
- + JSON-RPC - + Since 0.24.0 - +
- +

Returns the primary account.

- - + + +
+ +
+
Parameters
+
0
+
+ +
+
Result
+
object
+
+ +
+ + +
+ + + + + +
+

isConnected

+ +
+ + JSON-RPC + + Since 0.26.0 + +
+ +
+ +

Returns the connection status and the connected network information.

+ +
- +
Parameters
0
- +
Result
object
- +
- +
- - - + + + - +

ledgerApi

- +
- + JSON-RPC - + Since 0.24.0 - +
- +

Proxy for the JSON-API endpoints. Injects authorization headers automatically.

- - + +
- +
Parameters
1
- +
Result
object
- +
- +
- - - + + + - +

listAccounts

- +
- + JSON-RPC - + Since 0.24.0 - +
- +

Lists the addresses (wallets) with their properties; including which network they are associated to and with signing provider is used.

- - + +
- +
Parameters
0
- +
Result
array[object]
- +
- +
- - - + + + + + +
+

messageSignature

+ +
+ + JSON-RPC + + Since 1.4.0 + +
+ +
+ + +
+ +
+
Parameters
+
0
+
+ +
+
Result
+
oneOf
+
+ +
+ + +
+ + + - +

prepareExecute

- +
- + JSON-RPC - + Since 0.24.0 - + + Changed 1.4.0 +
- +

Prepares a transaction for subsequent signing & execution.

- - + +
- +
Parameters
1
- +
Result
null
- +
- +
- - - + + + - +

prepareExecuteAndWait

- +
- + JSON-RPC - + Since 0.24.0 - + + Changed 1.4.0 +
- +

Like prepareExecute, but waits for the transaction to be executed on the ledger.

- - + +
- +
Parameters
1
- +
Result
object
- +
- +
- - - + + + - +

signMessage

- +
- + JSON-RPC - + Since 0.24.0 - +
- +

Signs a message.

- - + +
- +
Parameters
1
- +
Result
object
- +
- +
- - - + + + - +

status

- +
- + JSON-RPC - + Since 0.24.0 - +
- +

Returns the current status of the wallet provider session.

- - + +
- +
Parameters
0
- +
Result
object
- +
- +
- - - + + + - +

txChanged

- +
- + JSON-RPC - + Since 0.24.0 - +
- - + +
- +
Parameters
0
- +
Result
oneOf
- +
- +
- - + +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-api/disconnect.mdx b/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-api/disconnect.mdx index 6545ad4b0..920b936f7 100644 --- a/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-api/disconnect.mdx +++ b/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-api/disconnect.mdx @@ -9,53 +9,53 @@ title: "disconnect"
- +

Sync dApp API

- - + +

disconnect

- - - + + +
- + JSON-RPC - + Since 0.24.0 - +
- +
- + POST - + JSON-RPC disconnect
@@ -63,32 +63,32 @@ title: "disconnect"
- +
Protocol
JSON-RPC
- +
Transport
HTTP POST
- +
Method
disconnect
- +
Parameters
0
- +
Result
null
- +
@@ -102,32 +102,32 @@ title: "disconnect"

result

- +
- - - + + +
- +
Shape
null
- +
Schema
Null
- +
- - - - - - - + + + + + + +
@@ -142,10 +142,10 @@ title: "disconnect"
- - - - + + + +
@@ -155,12 +155,12 @@ title: "disconnect"
- +
cURL - +
```bash cURL @@ -178,14 +178,14 @@ EOF
- +
Result - + application/json - +
```json Result @@ -194,7 +194,7 @@ EOF
- +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-api/getactivenetwork.mdx b/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-api/getactivenetwork.mdx index f1801747e..3147234d4 100644 --- a/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-api/getactivenetwork.mdx +++ b/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-api/getactivenetwork.mdx @@ -9,53 +9,53 @@ title: "getActiveNetwork"
- +

Sync dApp API

- - + +

getActiveNetwork

- - - + + +
- + JSON-RPC - + Since 0.24.0 - +
- +
- + POST - + JSON-RPC getActiveNetwork
@@ -63,32 +63,32 @@ title: "getActiveNetwork"
- +
Protocol
JSON-RPC
- +
Transport
HTTP POST
- +
Method
getActiveNetwork
- +
Parameters
0
- +
Result
object
- +
@@ -102,52 +102,52 @@ title: "getActiveNetwork"

result

- +
- - - + + +
- +
Shape
object
- +
Schema
Network
- +
Required
networkId
- +
- - - + + +
- +
networkId string - + required - +
- +
- +
- - - - + + + +
@@ -162,25 +162,25 @@ title: "getActiveNetwork"
- - + +
- +
networkId string - + required - +
- +
- +
- - + +
@@ -190,12 +190,12 @@ title: "getActiveNetwork"
- +
cURL - +
```bash cURL @@ -213,14 +213,14 @@ EOF
- +
Result - + application/json - +
```json Result @@ -231,7 +231,7 @@ EOF
- +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-api/getprimaryaccount.mdx b/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-api/getprimaryaccount.mdx index 94decf9e8..2e0b42fa8 100644 --- a/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-api/getprimaryaccount.mdx +++ b/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-api/getprimaryaccount.mdx @@ -9,53 +9,53 @@ title: "getPrimaryAccount"
- +

Sync dApp API

- - + +

getPrimaryAccount

- - - + + +
- + JSON-RPC - + Since 0.24.0 - +
- +
- + POST - + JSON-RPC getPrimaryAccount
@@ -63,32 +63,32 @@ title: "getPrimaryAccount"
- +
Protocol
JSON-RPC
- +
Transport
HTTP POST
- +
Method
getPrimaryAccount
- +
Parameters
0
- +
Result
object
- +
@@ -102,129 +102,129 @@ title: "getPrimaryAccount"

result

- +
- - - + + +
- +
Shape
object
- +
Schema
Wallet
- +
Required
hint, namespace, networkId, partyId, primary, publicKey, signingProviderId, status
- +
- - - + + +
- +
primary string - + required - +
- +
- +
partyId string - + required - +
- +
- +
status string - + required - +
- +
- +
hint string - + required - +
- +
- +
publicKey string - + required - +
- +
- +
namespace string - + required - +
- +
- +
networkId string - + required - +
- +
- +
signingProviderId string - + required - +
- +
- +
- - - - + + + +
@@ -239,102 +239,102 @@ title: "getPrimaryAccount"
- - + +
- +
primary string - + required - +
- +
- +
partyId string - + required - +
- +
- +
status string - + required - +
- +
- +
hint string - + required - +
- +
- +
publicKey string - + required - +
- +
- +
namespace string - + required - +
- +
- +
networkId string - + required - +
- +
- +
signingProviderId string - + required - +
- +
- +
- - + +
@@ -344,12 +344,12 @@ title: "getPrimaryAccount"
- +
cURL - +
```bash cURL @@ -367,14 +367,14 @@ EOF
- +
Result - + application/json - +
```json Result @@ -392,7 +392,7 @@ EOF
- +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-api/isconnected.mdx b/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-api/isconnected.mdx new file mode 100644 index 000000000..25fbca9a3 --- /dev/null +++ b/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-api/isconnected.mdx @@ -0,0 +1,260 @@ +--- +title: "isConnected" +--- + +
+ +
+
+ + + + + +
+ +

Sync dApp API

+ + +

isConnected

+ + + +
+ + JSON-RPC + + Since 0.26.0 + +
+ + +
+ +
+ + POST + + JSON-RPC isConnected +
+ +## Protocol Details + + +
+ +
+
Protocol
+
JSON-RPC
+
+ +
+
Transport
+
HTTP POST
+
+ +
+
Method
+
isConnected
+
+ +
+
Parameters
+
0
+
+ +
+
Result
+
object
+
+ +
+ + +## Inputs + + + +## Outputs + + +
+
+

result

+ +
+ + + +
+ +
+
Shape
+
object
+
+ +
+
Schema
+
ConnectResult
+
+ +
+
Required
+
isConnected, isNetworkConnected
+
+ +
+ + + + +
+ +
+
+ isConnected + string + + required + +
+ +
+ +
+
+ isNetworkConnected + string + + required + +
+ +
+ +
+ + + + + +
+ + + + + + + +## Related Schemas + + + + +
+ + +
+ +
+
+ isConnected + string + + required + +
+ +
+ +
+
+ isNetworkConnected + string + + required + +
+ +
+ +
+ + + +
+
+ +
+ + +
+ +
+ +
+
+
+ cURL + +
+ +```bash cURL +curl \ + \ + -H 'content-type: application/json' \ + --data @- <<'EOF' +{ + "jsonrpc": "2.0", + "id": 1, + "method": "isConnected" +} +EOF +``` + +
+
+ +
+
+
+ Result + + application/json + +
+ +```json Result +{ + "isConnected": "", + "isNetworkConnected": "" +} +``` + +
+
+ +
+ +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-api/ledgerapi.mdx b/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-api/ledgerapi.mdx index 689e68b87..f3477799b 100644 --- a/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-api/ledgerapi.mdx +++ b/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-api/ledgerapi.mdx @@ -9,53 +9,53 @@ title: "ledgerApi"
- +

Sync dApp API

- - + +

ledgerApi

- - - + + +
- + JSON-RPC - + Since 0.24.0 - +
- +
- + POST - + JSON-RPC ledgerApi
@@ -63,32 +63,32 @@ title: "ledgerApi"
- +
Protocol
JSON-RPC
- +
Transport
HTTP POST
- +
Method
ledgerApi
- +
Parameters
1
- +
Result
object
- +
@@ -98,63 +98,63 @@ title: "ledgerApi"

params

- +
- - - + + +
- +
Shape
object
- +
Schema
LedgerApiRequest
- +
Required
requestMethod, resource
- +
- - - + + +
- +
requestMethod string - + required - +
- +
- +
resource string - + required - +
- +
- +
- - - - + + + +
@@ -164,32 +164,32 @@ title: "ledgerApi"

result

- +
- - - + + +
- +
Shape
object
- +
Schema
LedgerApiResult
- +
- - - - - - - + + + + + + +
@@ -204,45 +204,45 @@ title: "ledgerApi"
- - + +
- +
requestMethod string - + required - +
- +
- +
resource string - + required - +
- +
- +
- - + +
- - - - + + + +
@@ -252,12 +252,12 @@ title: "ledgerApi"
- +
cURL - +
```bash cURL @@ -281,14 +281,14 @@ EOF
- +
Result - + application/json - +
```json Result @@ -297,7 +297,7 @@ EOF
- +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-api/listaccounts.mdx b/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-api/listaccounts.mdx index 81390d26e..815cfa06e 100644 --- a/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-api/listaccounts.mdx +++ b/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-api/listaccounts.mdx @@ -9,53 +9,53 @@ title: "listAccounts"
- +

Sync dApp API

- - + +

listAccounts

- - - + + +
- + JSON-RPC - + Since 0.24.0 - +
- +
- + POST - + JSON-RPC listAccounts
@@ -63,32 +63,32 @@ title: "listAccounts"
- +
Protocol
JSON-RPC
- +
Transport
HTTP POST
- +
Method
listAccounts
- +
Parameters
0
- +
Result
array[object]
- +
@@ -102,47 +102,47 @@ title: "listAccounts"

result

- +
- - - + + +
- +
Shape
array[object]
- +
Schema
ListAccountsResult
- +
- - - + + +
- +
items object - + required - +
- +
- +
- - - - + + + +
@@ -157,25 +157,25 @@ title: "listAccounts"
- - + +
- +
items object - + required - +
- +
- +
- - + +
@@ -185,12 +185,12 @@ title: "listAccounts"
- +
cURL - +
```bash cURL @@ -208,14 +208,14 @@ EOF
- +
Result - + application/json - +
```json Result @@ -235,7 +235,7 @@ EOF
- +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-api/messagesignature.mdx b/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-api/messagesignature.mdx new file mode 100644 index 000000000..bdbbdba4a --- /dev/null +++ b/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-api/messagesignature.mdx @@ -0,0 +1,247 @@ +--- +title: "messageSignature" +--- + +
+ +
+
+ + + + + +
+ +

Sync dApp API

+ + +

messageSignature

+ + + +
+ + JSON-RPC + + Since 1.4.0 + +
+ + +
+ +
+ + POST + + JSON-RPC messageSignature +
+ +## Protocol Details + + +
+ +
+
Protocol
+
JSON-RPC
+
+ +
+
Transport
+
HTTP POST
+
+ +
+
Method
+
messageSignature
+
+ +
+
Parameters
+
0
+
+ +
+
Result
+
oneOf
+
+ +
+ + +## Inputs + + + +## Outputs + + +
+
+

result

+ +
+ + + +
+ +
+
Shape
+
oneOf
+
+ +
+
Schema
+
MessageSignatureEvent
+
+ +
+ + + + +
+ +
+
+ status + string + +
+ +
+ +
+
+ messageId + string + +
+ +
+ +
+ + + + + +
+ + + + + + + +## Related Schemas + + + + +
+ + +
+ +
+
+ status + string + +
+ +
+ +
+
+ messageId + string + +
+ +
+ +
+ + + +
+
+ +
+ + +
+ +
+ +
+
+
+ cURL + +
+ +```bash cURL +curl \ + \ + -H 'content-type: application/json' \ + --data @- <<'EOF' +{ + "jsonrpc": "2.0", + "id": 1, + "method": "messageSignature" +} +EOF +``` + +
+
+ +
+
+
+ Result + + application/json + +
+ +```json Result +{ + "status": "", + "messageId": "" +} +``` + +
+
+ +
+ +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-api/prepareexecute.mdx b/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-api/prepareexecute.mdx index 9f04ad877..3f03081b0 100644 --- a/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-api/prepareexecute.mdx +++ b/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-api/prepareexecute.mdx @@ -9,53 +9,55 @@ title: "prepareExecute"
- +

Sync dApp API

- - + +

prepareExecute

- - - + + +
- + JSON-RPC - + Since 0.24.0 - + + Changed 1.4.0 +
- +
- + POST - + JSON-RPC prepareExecute
@@ -63,32 +65,32 @@ title: "prepareExecute"
- +
Protocol
JSON-RPC
- +
Transport
HTTP POST
- +
Method
prepareExecute
- +
Parameters
1
- +
Result
null
- +
@@ -98,52 +100,52 @@ title: "prepareExecute"

params

- +
- - - + + +
- +
Shape
object
- +
Schema
JsPrepareSubmissionRequest
- +
Required
commands
- +
- - - + + +
- +
commands - object - + array[object] + required - +
- +
- +
- - - - + + + +
@@ -153,38 +155,49 @@ title: "prepareExecute"

result

- +
- - - + + +
- +
Shape
null
- +
Schema
Null
- +
- - - - - - - + + + + + + +
+## Lifecycle Changes + +
+ +
+ 1.4.0 + details updated +
+ +
+ ## Related Schemas @@ -193,34 +206,34 @@ title: "prepareExecute"
- - + +
- +
commands - object - + array[object] + required - +
- +
- +
- - + +
- - - - + + + +
@@ -230,12 +243,12 @@ title: "prepareExecute"
- +
cURL - +
```bash cURL @@ -249,7 +262,11 @@ curl \ "method": "prepareExecute", "params": { "params": { - "commands": {} + "commands": [ + { + "CreateCommand": {} + } + ] } } } @@ -258,14 +275,14 @@ EOF
- +
Result - + application/json - +
```json Result @@ -274,7 +291,7 @@ EOF
- +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-api/prepareexecuteandwait.mdx b/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-api/prepareexecuteandwait.mdx index d163f556c..a2dca2b70 100644 --- a/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-api/prepareexecuteandwait.mdx +++ b/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-api/prepareexecuteandwait.mdx @@ -9,53 +9,55 @@ title: "prepareExecuteAndWait"
- +

Sync dApp API

- - + +

prepareExecuteAndWait

- - - + + +
- + JSON-RPC - + Since 0.24.0 - + + Changed 1.4.0 +
- +
- + POST - + JSON-RPC prepareExecuteAndWait
@@ -63,32 +65,32 @@ title: "prepareExecuteAndWait"
- +
Protocol
JSON-RPC
- +
Transport
HTTP POST
- +
Method
prepareExecuteAndWait
- +
Parameters
1
- +
Result
object
- +
@@ -98,52 +100,52 @@ title: "prepareExecuteAndWait"

params

- +
- - - + + +
- +
Shape
object
- +
Schema
JsPrepareSubmissionRequest
- +
Required
commands
- +
- - - + + +
- +
commands - object - + array[object] + required - +
- +
- +
- - - - + + + +
@@ -153,53 +155,64 @@ title: "prepareExecuteAndWait"

result

- +
- - - + + +
- +
Shape
object
- +
Required
tx
- +
- - - + + +
- +
tx object - + required - +
- +
- +
- - - - + + + +
+## Lifecycle Changes + +
+ +
+ 1.4.0 + details updated +
+ +
+ ## Related Schemas @@ -208,49 +221,49 @@ title: "prepareExecuteAndWait"
- - + +
- +
commands - object - + array[object] + required - +
- +
- +
- - + +
- - + +
- +
tx object - + required - +
- +
- +
- - + +
@@ -260,12 +273,12 @@ title: "prepareExecuteAndWait"
- +
cURL - +
```bash cURL @@ -279,7 +292,11 @@ curl \ "method": "prepareExecuteAndWait", "params": { "params": { - "commands": {} + "commands": [ + { + "CreateCommand": {} + } + ] } } } @@ -288,14 +305,14 @@ EOF
- +
Result - + application/json - +
```json Result @@ -313,7 +330,7 @@ EOF
- +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-api/signmessage.mdx b/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-api/signmessage.mdx index 9977f23d4..545d952b2 100644 --- a/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-api/signmessage.mdx +++ b/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-api/signmessage.mdx @@ -9,53 +9,53 @@ title: "signMessage"
- +

Sync dApp API

- - + +

signMessage

- - - + + +
- + JSON-RPC - + Since 0.24.0 - +
- +
- + POST - + JSON-RPC signMessage
@@ -63,32 +63,32 @@ title: "signMessage"
- +
Protocol
JSON-RPC
- +
Transport
HTTP POST
- +
Method
signMessage
- +
Parameters
1
- +
Result
object
- +
@@ -98,52 +98,52 @@ title: "signMessage"

params

- +
- - - + + +
- +
Shape
object
- +
Schema
SignMessageRequest
- +
Required
message
- +
- - - + + +
- +
message string - + required - +
- +
- +
- - - - + + + +
@@ -153,52 +153,52 @@ title: "signMessage"

result

- +
- - - + + +
- +
Shape
object
- +
Schema
SignMessageResult
- +
Required
signature
- +
- - - + + +
- +
signature string - + required - +
- +
- +
- - - - + + + +
@@ -213,49 +213,49 @@ title: "signMessage"
- - + +
- +
message string - + required - +
- +
- +
- - + +
- - + +
- +
signature string - + required - +
- +
- +
- - + +
@@ -265,12 +265,12 @@ title: "signMessage"
- +
cURL - +
```bash cURL @@ -293,14 +293,14 @@ EOF
- +
Result - + application/json - +
```json Result @@ -311,7 +311,7 @@ EOF
- +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-api/status.mdx b/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-api/status.mdx index 14a95177a..90372ccaf 100644 --- a/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-api/status.mdx +++ b/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-api/status.mdx @@ -9,53 +9,53 @@ title: "status"
- +

Sync dApp API

- - + +

status

- - - + + +
- + JSON-RPC - + Since 0.24.0 - +
- +
- + POST - + JSON-RPC status
@@ -63,32 +63,32 @@ title: "status"
- +
Protocol
JSON-RPC
- +
Transport
HTTP POST
- +
Method
status
- +
Parameters
0
- +
Result
object
- +
@@ -102,63 +102,63 @@ title: "status"

result

- +
- - - + + +
- +
Shape
object
- +
Schema
StatusEvent
- +
Required
connection, provider
- +
- - - + + +
- +
provider object - + required - +
- +
- +
connection object - + required - +
- +
- +
- - - - + + + +
@@ -173,36 +173,36 @@ title: "status"
- - + +
- +
provider object - + required - +
- +
- +
connection object - + required - +
- +
- +
- - + +
@@ -212,12 +212,12 @@ title: "status"
- +
cURL - +
```bash cURL @@ -235,14 +235,14 @@ EOF
- +
Result - + application/json - +
```json Result @@ -259,7 +259,7 @@ EOF
- +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-api/txchanged.mdx b/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-api/txchanged.mdx index 3171ba9a7..094bc5204 100644 --- a/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-api/txchanged.mdx +++ b/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-api/txchanged.mdx @@ -9,53 +9,53 @@ title: "txChanged"
- +

Sync dApp API

- - + +

txChanged

- - - + + +
- + JSON-RPC - + Since 0.24.0 - +
- +
- + POST - + JSON-RPC txChanged
@@ -63,32 +63,32 @@ title: "txChanged"
- +
Protocol
JSON-RPC
- +
Transport
HTTP POST
- +
Method
txChanged
- +
Parameters
0
- +
Result
oneOf
- +
@@ -102,54 +102,54 @@ title: "txChanged"

result

- +
- - - + + +
- +
Shape
oneOf
- +
Schema
TxChangedEvent
- +
- - - + + +
- +
status string - +
- +
- +
commandId string - +
- +
- +
- - - - + + + +
@@ -164,32 +164,32 @@ title: "txChanged"
- - + +
- +
status string - +
- +
- +
commandId string - +
- +
- +
- - + +
@@ -199,12 +199,12 @@ title: "txChanged"
- +
cURL - +
```bash cURL @@ -222,14 +222,14 @@ EOF
- +
Result - + application/json - +
```json Result @@ -241,7 +241,7 @@ EOF
- +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-remote-api/accountschanged.mdx b/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-remote-api/accountschanged.mdx index 7eef9d593..41445ca44 100644 --- a/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-remote-api/accountschanged.mdx +++ b/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-remote-api/accountschanged.mdx @@ -9,53 +9,53 @@ title: "accountsChanged"
- +

Async dApp API

- - + +

accountsChanged

- - - + + +
- + JSON-RPC - + Since 0.24.0 - +
- +
- + POST - + JSON-RPC accountsChanged
@@ -63,32 +63,32 @@ title: "accountsChanged"
- +
Protocol
JSON-RPC
- +
Transport
HTTP POST
- +
Method
accountsChanged
- +
Parameters
0
- +
Result
array[object]
- +
@@ -102,47 +102,47 @@ title: "accountsChanged"

result

- +
- - - + + +
- +
Shape
array[object]
- +
Schema
AccountsChangedEvent
- +
- - - + + +
- +
items object - + required - +
- +
- +
- - - - + + + +
@@ -157,25 +157,25 @@ title: "accountsChanged"
- - + +
- +
items object - + required - +
- +
- +
- - + +
@@ -185,12 +185,12 @@ title: "accountsChanged"
- +
cURL - +
```bash cURL @@ -208,14 +208,14 @@ EOF
- +
Result - + application/json - +
```json Result @@ -235,7 +235,7 @@ EOF
- +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-remote-api/connect.mdx b/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-remote-api/connect.mdx index 99d56c37f..41820a8bb 100644 --- a/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-remote-api/connect.mdx +++ b/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-remote-api/connect.mdx @@ -9,53 +9,53 @@ title: "connect"
- +

Async dApp API

- - + +

connect

- - - + + +
- + JSON-RPC - + Since 0.24.0 - +
- +
- + POST - + JSON-RPC connect
@@ -63,32 +63,32 @@ title: "connect"
- +
Protocol
JSON-RPC
- +
Transport
HTTP POST
- +
Method
connect
- +
Parameters
0
- +
Result
object
- +
@@ -102,63 +102,63 @@ title: "connect"

result

- +
- - - + + +
- +
Shape
object
- +
Schema
ConnectResult
- +
Required
isConnected, isNetworkConnected
- +
- - - + + +
- +
isConnected string - + required - +
- +
- +
isNetworkConnected string - + required - +
- +
- +
- - - - + + + +
@@ -173,36 +173,36 @@ title: "connect"
- - + +
- +
isConnected string - + required - +
- +
- +
isNetworkConnected string - + required - +
- +
- +
- - + +
@@ -212,12 +212,12 @@ title: "connect"
- +
cURL - +
```bash cURL @@ -235,14 +235,14 @@ EOF
- +
Result - + application/json - +
```json Result @@ -254,7 +254,7 @@ EOF
- +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-remote-api/connected.mdx b/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-remote-api/connected.mdx index 4a00f1b86..6c8ce89e5 100644 --- a/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-remote-api/connected.mdx +++ b/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-remote-api/connected.mdx @@ -9,53 +9,53 @@ title: "connected"
- +

Async dApp API

- - + +

connected

- - - + + +
- + JSON-RPC - + Since 0.24.0 - +
- +
- + POST - + JSON-RPC connected
@@ -63,32 +63,32 @@ title: "connected"
- +
Protocol
JSON-RPC
- +
Transport
HTTP POST
- +
Method
connected
- +
Parameters
0
- +
Result
object
- +
@@ -102,63 +102,63 @@ title: "connected"

result

- +
- - - + + +
- +
Shape
object
- +
Schema
StatusEvent
- +
Required
connection, provider
- +
- - - + + +
- +
provider object - + required - +
- +
- +
connection object - + required - +
- +
- +
- - - - + + + +
@@ -173,36 +173,36 @@ title: "connected"
- - + +
- +
provider object - + required - +
- +
- +
connection object - + required - +
- +
- +
- - + +
@@ -212,12 +212,12 @@ title: "connected"
- +
cURL - +
```bash cURL @@ -235,14 +235,14 @@ EOF
- +
Result - + application/json - +
```json Result @@ -259,7 +259,7 @@ EOF
- +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-remote-api/details.mdx b/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-remote-api/details.mdx index 28bcb1ef2..b966ef79b 100644 --- a/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-remote-api/details.mdx +++ b/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-remote-api/details.mdx @@ -1,54 +1,54 @@ --- title: "Details and history" +description: "An OpenRPC specification for remotely hosted Wallet Providers. Due to the remote nature, an implementing provider must bridge certain functionality on the client-side to satisfy the general dApp API spec." --- -
+

Back to overview

-
-
+
+

OpenRPC Spec

-
- -

openrpc spec

- -

Async dApp API

-

Details and history

-

An OpenRPC specification for remotely hosted Wallet Providers. Due to the remote nature, an implementing provider must bridge certain functionality on the client-side to satisfy the general dApp API spec.

- -
- - JSON-RPC - - Since 0.24.0 - -
-
-
+

Async dApp API

+ + +

An OpenRPC specification for remotely hosted Wallet Providers. Due to the remote nature, an implementing provider must bridge certain functionality on the client-side to satisfy the general dApp API spec.

+ + +
+ + JSON-RPC + + Since 0.24.0 + + Changed 1.4.0 + +
+
- +
Latest source path
api-specs/openrpc-dapp-remote-api.json
- +
Publish version
-
0.25.0
+
1.4.0
- +
OpenRPC version
1.2.6
- +
Spec info.version
0.1.0
- +
@@ -62,478 +62,554 @@ Method pages are the primary reference surface. This spec page stays focused on
- - + + - +

accountsChanged

- +
- + JSON-RPC - + Since 0.24.0 - +
- - + +
- +
Parameters
0
- +
Result
array[object]
- +
- +
- - - + + + - +

connect

- +
- + JSON-RPC - + Since 0.24.0 - +
- +

Ensures ledger connectivity and returns the connected network information.

- - + +
- +
Parameters
0
- +
Result
object
- +
- +
- - - + + + - +

connected

- +
- + JSON-RPC - + Since 0.24.0 - +
- +

Informs when the user connects to a network.

- - + +
- +
Parameters
0
- +
Result
object
- +
- +
- - - + + + - +

disconnect

- +
- + JSON-RPC - + Since 0.24.0 - +
- +

Invoke a disconnect of the wallet gateway session.

- - + +
- +
Parameters
0
- +
Result
null
- +
- +
- - - + + + - +

getActiveNetwork

- +
- + JSON-RPC - + Since 0.24.0 - +
- +

Returns the active network.

- - + +
- +
Parameters
0
- +
Result
object
- +
- +
- - - + + + - +

getPrimaryAccount

- +
- + JSON-RPC - + Since 0.24.0 - +
- +

Returns the primary account.

- - + +
- +
Parameters
0
- +
Result
object
- +
- +
- - - + + + + + +
+

isConnected

+ +
+ + JSON-RPC + + Since 0.26.0 + +
+ +
+ +

Returns the connection status and the connected network information.

+ + +
+ +
+
Parameters
+
0
+
+ +
+
Result
+
object
+
+ +
+ + +
+ + + - +

ledgerApi

- +
- + JSON-RPC - + Since 0.24.0 - +
- +

Proxy for the JSON-API endpoints. Injects authorization headers automatically.

- - + +
- +
Parameters
1
- +
Result
object
- +
- +
- - - + + + - +

listAccounts

- +
- + JSON-RPC - + Since 0.24.0 - +
- - + +
- +
Parameters
0
- +
Result
array[object]
- + +
+ + +
+ + + + + +
+

messageSignature

+ +
+ + JSON-RPC + + Since 1.4.0 + +
+ +
+ + +
+ +
+
Parameters
+
0
+
+ +
+
Result
+
oneOf
+
+
- +
- - - + + + - +

onStatusChanged

- +
- + JSON-RPC - + Since 0.24.0 - +
- - + +
- +
Parameters
0
- +
Result
object
- +
- +
- - - + + + - +

prepareExecute

- +
- + JSON-RPC - + Since 0.24.0 - + + Changed 1.4.0 +
- +

Prepares, signs, and executes a transaction.

- - + +
- +
Parameters
1
- +
Result
object
- +
- +
- - - + + + - +

signMessage

- +
- + JSON-RPC - + Since 0.24.0 - + + Changed 1.4.0 +
- -

Signs a message.

- - + +

Requests a message signature. The wallet will prompt the user for confirmation.

+ +
- +
Parameters
1
- +
Result
object
- +
- +
- - - + + + - +

status

- +
- + JSON-RPC - + Since 0.24.0 - +
- +

Returns the current status of the wallet provider session.

- - + +
- +
Parameters
0
- +
Result
object
- +
- +
- - - + + + - +

txChanged

- +
- + JSON-RPC - + Since 0.24.0 - +
- - + +
- +
Parameters
0
- +
Result
oneOf
- +
- +
- - + +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-remote-api/disconnect.mdx b/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-remote-api/disconnect.mdx index 5d3f2e7d1..750e58536 100644 --- a/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-remote-api/disconnect.mdx +++ b/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-remote-api/disconnect.mdx @@ -9,53 +9,53 @@ title: "disconnect"
- +

Async dApp API

- - + +

disconnect

- - - + + +
- + JSON-RPC - + Since 0.24.0 - +
- +
- + POST - + JSON-RPC disconnect
@@ -63,32 +63,32 @@ title: "disconnect"
- +
Protocol
JSON-RPC
- +
Transport
HTTP POST
- +
Method
disconnect
- +
Parameters
0
- +
Result
null
- +
@@ -102,32 +102,32 @@ title: "disconnect"

result

- +
- - - + + +
- +
Shape
null
- +
Schema
Null
- +
- - - - - - - + + + + + + +
@@ -142,10 +142,10 @@ title: "disconnect"
- - - - + + + +
@@ -155,12 +155,12 @@ title: "disconnect"
- +
cURL - +
```bash cURL @@ -178,14 +178,14 @@ EOF
- +
Result - + application/json - +
```json Result @@ -194,7 +194,7 @@ EOF
- +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-remote-api/getactivenetwork.mdx b/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-remote-api/getactivenetwork.mdx index 7455761bb..06ee61098 100644 --- a/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-remote-api/getactivenetwork.mdx +++ b/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-remote-api/getactivenetwork.mdx @@ -9,53 +9,53 @@ title: "getActiveNetwork"
- +

Async dApp API

- - + +

getActiveNetwork

- - - + + +
- + JSON-RPC - + Since 0.24.0 - +
- +
- + POST - + JSON-RPC getActiveNetwork
@@ -63,32 +63,32 @@ title: "getActiveNetwork"
- +
Protocol
JSON-RPC
- +
Transport
HTTP POST
- +
Method
getActiveNetwork
- +
Parameters
0
- +
Result
object
- +
@@ -102,52 +102,52 @@ title: "getActiveNetwork"

result

- +
- - - + + +
- +
Shape
object
- +
Schema
Network
- +
Required
networkId
- +
- - - + + +
- +
networkId string - + required - +
- +
- +
- - - - + + + +
@@ -162,25 +162,25 @@ title: "getActiveNetwork"
- - + +
- +
networkId string - + required - +
- +
- +
- - + +
@@ -190,12 +190,12 @@ title: "getActiveNetwork"
- +
cURL - +
```bash cURL @@ -213,14 +213,14 @@ EOF
- +
Result - + application/json - +
```json Result @@ -231,7 +231,7 @@ EOF
- +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-remote-api/getprimaryaccount.mdx b/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-remote-api/getprimaryaccount.mdx index 52a15e0a7..67efb096f 100644 --- a/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-remote-api/getprimaryaccount.mdx +++ b/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-remote-api/getprimaryaccount.mdx @@ -9,53 +9,53 @@ title: "getPrimaryAccount"
- +

Async dApp API

- - + +

getPrimaryAccount

- - - + + +
- + JSON-RPC - + Since 0.24.0 - +
- +
- + POST - + JSON-RPC getPrimaryAccount
@@ -63,32 +63,32 @@ title: "getPrimaryAccount"
- +
Protocol
JSON-RPC
- +
Transport
HTTP POST
- +
Method
getPrimaryAccount
- +
Parameters
0
- +
Result
object
- +
@@ -102,129 +102,129 @@ title: "getPrimaryAccount"

result

- +
- - - + + +
- +
Shape
object
- +
Schema
Wallet
- +
Required
hint, namespace, networkId, partyId, primary, publicKey, rights, signingProviderId, status
- +
- - - + + +
- +
primary string - + required - +
- +
- +
partyId string - + required - +
- +
- +
status string - + required - +
- +
- +
hint string - + required - +
- +
- +
publicKey string - + required - +
- +
- +
namespace string - + required - +
- +
- +
networkId string - + required - +
- +
- +
signingProviderId string - + required - +
- +
- +
- - - - + + + +
@@ -239,102 +239,102 @@ title: "getPrimaryAccount"
- - + +
- +
primary string - + required - +
- +
- +
partyId string - + required - +
- +
- +
status string - + required - +
- +
- +
hint string - + required - +
- +
- +
publicKey string - + required - +
- +
- +
namespace string - + required - +
- +
- +
networkId string - + required - +
- +
- +
signingProviderId string - + required - +
- +
- +
- - + +
@@ -344,12 +344,12 @@ title: "getPrimaryAccount"
- +
cURL - +
```bash cURL @@ -367,14 +367,14 @@ EOF
- +
Result - + application/json - +
```json Result @@ -392,7 +392,7 @@ EOF
- +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-remote-api/isconnected.mdx b/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-remote-api/isconnected.mdx new file mode 100644 index 000000000..e81544e07 --- /dev/null +++ b/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-remote-api/isconnected.mdx @@ -0,0 +1,260 @@ +--- +title: "isConnected" +--- + +
+ +
+
+ + + + + +
+ +

Async dApp API

+ + +

isConnected

+ + + +
+ + JSON-RPC + + Since 0.26.0 + +
+ + +
+ +
+ + POST + + JSON-RPC isConnected +
+ +## Protocol Details + + +
+ +
+
Protocol
+
JSON-RPC
+
+ +
+
Transport
+
HTTP POST
+
+ +
+
Method
+
isConnected
+
+ +
+
Parameters
+
0
+
+ +
+
Result
+
object
+
+ +
+ + +## Inputs + + + +## Outputs + + +
+
+

result

+ +
+ + + +
+ +
+
Shape
+
object
+
+ +
+
Schema
+
ConnectResult
+
+ +
+
Required
+
isConnected, isNetworkConnected
+
+ +
+ + + + +
+ +
+
+ isConnected + string + + required + +
+ +
+ +
+
+ isNetworkConnected + string + + required + +
+ +
+ +
+ + + + + +
+ + + + + + + +## Related Schemas + + + + +
+ + +
+ +
+
+ isConnected + string + + required + +
+ +
+ +
+
+ isNetworkConnected + string + + required + +
+ +
+ +
+ + + +
+
+ +
+ + +
+ +
+ +
+
+
+ cURL + +
+ +```bash cURL +curl \ + \ + -H 'content-type: application/json' \ + --data @- <<'EOF' +{ + "jsonrpc": "2.0", + "id": 1, + "method": "isConnected" +} +EOF +``` + +
+
+ +
+
+
+ Result + + application/json + +
+ +```json Result +{ + "isConnected": "", + "isNetworkConnected": "" +} +``` + +
+
+ +
+ +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-remote-api/ledgerapi.mdx b/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-remote-api/ledgerapi.mdx index 514686bb1..71d32e211 100644 --- a/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-remote-api/ledgerapi.mdx +++ b/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-remote-api/ledgerapi.mdx @@ -9,53 +9,53 @@ title: "ledgerApi"
- +

Async dApp API

- - + +

ledgerApi

- - - + + +
- + JSON-RPC - + Since 0.24.0 - +
- +
- + POST - + JSON-RPC ledgerApi
@@ -63,32 +63,32 @@ title: "ledgerApi"
- +
Protocol
JSON-RPC
- +
Transport
HTTP POST
- +
Method
ledgerApi
- +
Parameters
1
- +
Result
object
- +
@@ -98,63 +98,63 @@ title: "ledgerApi"

params

- +
- - - + + +
- +
Shape
object
- +
Schema
LedgerApiRequest
- +
Required
requestMethod, resource
- +
- - - + + +
- +
requestMethod string - + required - +
- +
- +
resource string - + required - +
- +
- +
- - - - + + + +
@@ -164,32 +164,32 @@ title: "ledgerApi"

result

- +
- - - + + +
- +
Shape
object
- +
Schema
LedgerApiResult
- +
- - - - - - - + + + + + + +
@@ -204,45 +204,45 @@ title: "ledgerApi"
- - + +
- +
requestMethod string - + required - +
- +
- +
resource string - + required - +
- +
- +
- - + +
- - - - + + + +
@@ -252,12 +252,12 @@ title: "ledgerApi"
- +
cURL - +
```bash cURL @@ -281,14 +281,14 @@ EOF
- +
Result - + application/json - +
```json Result @@ -297,7 +297,7 @@ EOF
- +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-remote-api/listaccounts.mdx b/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-remote-api/listaccounts.mdx index 14cd1edb2..07afde4d4 100644 --- a/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-remote-api/listaccounts.mdx +++ b/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-remote-api/listaccounts.mdx @@ -9,53 +9,53 @@ title: "listAccounts"
- +

Async dApp API

- - + +

listAccounts

- - - + + +
- + JSON-RPC - + Since 0.24.0 - +
- +
- + POST - + JSON-RPC listAccounts
@@ -63,32 +63,32 @@ title: "listAccounts"
- +
Protocol
JSON-RPC
- +
Transport
HTTP POST
- +
Method
listAccounts
- +
Parameters
0
- +
Result
array[object]
- +
@@ -102,47 +102,47 @@ title: "listAccounts"

result

- +
- - - + + +
- +
Shape
array[object]
- +
Schema
ListAccountsResult
- +
- - - + + +
- +
items object - + required - +
- +
- +
- - - - + + + +
@@ -157,25 +157,25 @@ title: "listAccounts"
- - + +
- +
items object - + required - +
- +
- +
- - + +
@@ -185,12 +185,12 @@ title: "listAccounts"
- +
cURL - +
```bash cURL @@ -208,14 +208,14 @@ EOF
- +
Result - + application/json - +
```json Result @@ -235,7 +235,7 @@ EOF
- +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-remote-api/messagesignature.mdx b/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-remote-api/messagesignature.mdx new file mode 100644 index 000000000..3081f3d0a --- /dev/null +++ b/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-remote-api/messagesignature.mdx @@ -0,0 +1,247 @@ +--- +title: "messageSignature" +--- + +
+ +
+
+ + + + + +
+ +

Async dApp API

+ + +

messageSignature

+ + + +
+ + JSON-RPC + + Since 1.4.0 + +
+ + +
+ +
+ + POST + + JSON-RPC messageSignature +
+ +## Protocol Details + + +
+ +
+
Protocol
+
JSON-RPC
+
+ +
+
Transport
+
HTTP POST
+
+ +
+
Method
+
messageSignature
+
+ +
+
Parameters
+
0
+
+ +
+
Result
+
oneOf
+
+ +
+ + +## Inputs + + + +## Outputs + + +
+
+

result

+ +
+ + + +
+ +
+
Shape
+
oneOf
+
+ +
+
Schema
+
MessageSignatureEvent
+
+ +
+ + + + +
+ +
+
+ status + string + +
+ +
+ +
+
+ messageId + string + +
+ +
+ +
+ + + + + +
+ + + + + + + +## Related Schemas + + + + +
+ + +
+ +
+
+ status + string + +
+ +
+ +
+
+ messageId + string + +
+ +
+ +
+ + + +
+
+ +
+ + +
+ +
+ +
+
+
+ cURL + +
+ +```bash cURL +curl \ + \ + -H 'content-type: application/json' \ + --data @- <<'EOF' +{ + "jsonrpc": "2.0", + "id": 1, + "method": "messageSignature" +} +EOF +``` + +
+
+ +
+
+
+ Result + + application/json + +
+ +```json Result +{ + "status": "", + "messageId": "" +} +``` + +
+
+ +
+ +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-remote-api/onstatuschanged.mdx b/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-remote-api/onstatuschanged.mdx index 4fa17afd3..ccae9b644 100644 --- a/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-remote-api/onstatuschanged.mdx +++ b/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-remote-api/onstatuschanged.mdx @@ -9,53 +9,53 @@ title: "onStatusChanged"
- +

Async dApp API

- - + +

onStatusChanged

- - - + + +
- + JSON-RPC - + Since 0.24.0 - +
- +
- + POST - + JSON-RPC onStatusChanged
@@ -63,32 +63,32 @@ title: "onStatusChanged"
- +
Protocol
JSON-RPC
- +
Transport
HTTP POST
- +
Method
onStatusChanged
- +
Parameters
0
- +
Result
object
- +
@@ -102,63 +102,63 @@ title: "onStatusChanged"

result

- +
- - - + + +
- +
Shape
object
- +
Schema
StatusEvent
- +
Required
connection, provider
- +
- - - + + +
- +
provider object - + required - +
- +
- +
connection object - + required - +
- +
- +
- - - - + + + +
@@ -173,36 +173,36 @@ title: "onStatusChanged"
- - + +
- +
provider object - + required - +
- +
- +
connection object - + required - +
- +
- +
- - + +
@@ -212,12 +212,12 @@ title: "onStatusChanged"
- +
cURL - +
```bash cURL @@ -235,14 +235,14 @@ EOF
- +
Result - + application/json - +
```json Result @@ -259,7 +259,7 @@ EOF
- +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-remote-api/prepareexecute.mdx b/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-remote-api/prepareexecute.mdx index e32af4cc3..376e111b7 100644 --- a/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-remote-api/prepareexecute.mdx +++ b/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-remote-api/prepareexecute.mdx @@ -9,53 +9,55 @@ title: "prepareExecute"
- +

Async dApp API

- - + +

prepareExecute

- - - + + +
- + JSON-RPC - + Since 0.24.0 - + + Changed 1.4.0 +
- +
- + POST - + JSON-RPC prepareExecute
@@ -63,32 +65,32 @@ title: "prepareExecute"
- +
Protocol
JSON-RPC
- +
Transport
HTTP POST
- +
Method
prepareExecute
- +
Parameters
1
- +
Result
object
- +
@@ -98,52 +100,52 @@ title: "prepareExecute"

params

- +
- - - + + +
- +
Shape
object
- +
Schema
JsPrepareSubmissionRequest
- +
Required
commands
- +
- - - + + +
- +
commands - object - + array[object] + required - +
- +
- +
- - - - + + + +
@@ -153,53 +155,64 @@ title: "prepareExecute"

result

- +
- - - + + +
- +
Shape
object
- +
Required
userUrl
- +
- - - + + +
- +
userUrl string - + required - +
- +
- +
- - - - + + + +
+## Lifecycle Changes + +
+ +
+ 1.4.0 + details updated +
+ +
+ ## Related Schemas @@ -208,49 +221,49 @@ title: "prepareExecute"
- - + +
- +
commands - object - + array[object] + required - +
- +
- +
- - + +
- - + +
- +
userUrl string - + required - +
- +
- +
- - + +
@@ -260,12 +273,12 @@ title: "prepareExecute"
- +
cURL - +
```bash cURL @@ -279,7 +292,11 @@ curl \ "method": "prepareExecute", "params": { "params": { - "commands": {} + "commands": [ + { + "CreateCommand": {} + } + ] } } } @@ -288,14 +305,14 @@ EOF
- +
Result - + application/json - +
```json Result @@ -306,7 +323,7 @@ EOF
- +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-remote-api/signmessage.mdx b/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-remote-api/signmessage.mdx index 77687782e..cb2a2a0cf 100644 --- a/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-remote-api/signmessage.mdx +++ b/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-remote-api/signmessage.mdx @@ -9,53 +9,55 @@ title: "signMessage"
- +

Async dApp API

- - + +

signMessage

- - - + + +
- + JSON-RPC - + Since 0.24.0 - + + Changed 1.4.0 +
- +
- + POST - + JSON-RPC signMessage
@@ -63,32 +65,32 @@ title: "signMessage"
- +
Protocol
JSON-RPC
- +
Transport
HTTP POST
- +
Method
signMessage
- +
Parameters
1
- +
Result
object
- +
@@ -98,52 +100,52 @@ title: "signMessage"

params

- +
- - - + + +
- +
Shape
object
- +
Schema
SignMessageRequest
- +
Required
message
- +
- - - + + +
- +
message string - + required - +
- +
- +
- - - - + + + +
@@ -153,58 +155,75 @@ title: "signMessage"

result

- +
- - - + + +
- +
Shape
object
- -
-
Schema
-
SignMessageResult
-
- +
Required
-
signature
+
messageId, userUrl
- +
- - - + + +
- + +
+
+ messageId + string + + required + +
+ +
+
- signature + userUrl string - + required - +
- +
- +
- - - - + + + +
+## Lifecycle Changes + +
+ +
+ 1.4.0 + description updated; result updated (schema ref, required fields) +
+ +
+ ## Related Schemas @@ -213,49 +232,60 @@ title: "signMessage"
- - + +
- +
message string - + required - +
- +
- +
- - + +
- +
- - + +
- +
- signature + messageId string - + required - +
- +
- + +
+
+ userUrl + string + + required + +
+ +
+
- - + +
@@ -265,12 +295,12 @@ title: "signMessage"
- +
cURL - +
```bash cURL @@ -293,25 +323,26 @@ EOF
- +
Result - + application/json - +
```json Result { - "signature": "" + "messageId": "", + "userUrl": "" } ```
- +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-remote-api/status.mdx b/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-remote-api/status.mdx index 45789e1c1..9775a1441 100644 --- a/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-remote-api/status.mdx +++ b/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-remote-api/status.mdx @@ -9,53 +9,53 @@ title: "status"
- +

Async dApp API

- - + +

status

- - - + + +
- + JSON-RPC - + Since 0.24.0 - +
- +
- + POST - + JSON-RPC status
@@ -63,32 +63,32 @@ title: "status"
- +
Protocol
JSON-RPC
- +
Transport
HTTP POST
- +
Method
status
- +
Parameters
0
- +
Result
object
- +
@@ -102,63 +102,63 @@ title: "status"

result

- +
- - - + + +
- +
Shape
object
- +
Schema
StatusEvent
- +
Required
connection, provider
- +
- - - + + +
- +
provider object - + required - +
- +
- +
connection object - + required - +
- +
- +
- - - - + + + +
@@ -173,36 +173,36 @@ title: "status"
- - + +
- +
provider object - + required - +
- +
- +
connection object - + required - +
- +
- +
- - + +
@@ -212,12 +212,12 @@ title: "status"
- +
cURL - +
```bash cURL @@ -235,14 +235,14 @@ EOF
- +
Result - + application/json - +
```json Result @@ -259,7 +259,7 @@ EOF
- +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-remote-api/txchanged.mdx b/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-remote-api/txchanged.mdx index 3f8ae21d6..f96e903ab 100644 --- a/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-remote-api/txchanged.mdx +++ b/docs-main/reference/wallet-gateway-json-rpc/operations/dapp-remote-api/txchanged.mdx @@ -9,53 +9,53 @@ title: "txChanged"
- +

Async dApp API

- - + +

txChanged

- - - + + +
- + JSON-RPC - + Since 0.24.0 - +
- +
- + POST - + JSON-RPC txChanged
@@ -63,32 +63,32 @@ title: "txChanged"
- +
Protocol
JSON-RPC
- +
Transport
HTTP POST
- +
Method
txChanged
- +
Parameters
0
- +
Result
oneOf
- +
@@ -102,54 +102,54 @@ title: "txChanged"

result

- +
- - - + + +
- +
Shape
oneOf
- +
Schema
TxChangedEvent
- +
- - - + + +
- +
status string - +
- +
- +
commandId string - +
- +
- +
- - - - + + + +
@@ -164,32 +164,32 @@ title: "txChanged"
- - + +
- +
status string - +
- +
- +
commandId string - +
- +
- +
- - + +
@@ -199,12 +199,12 @@ title: "txChanged"
- +
cURL - +
```bash cURL @@ -222,14 +222,14 @@ EOF
- +
Result - + application/json - +
```json Result @@ -241,7 +241,7 @@ EOF
- +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/operations/details.mdx b/docs-main/reference/wallet-gateway-json-rpc/operations/details.mdx index acb0d3b1e..4a607bbac 100644 --- a/docs-main/reference/wallet-gateway-json-rpc/operations/details.mdx +++ b/docs-main/reference/wallet-gateway-json-rpc/operations/details.mdx @@ -4,47 +4,47 @@ description: "Versioned OpenRPC reference docs." ---
- +

OpenRPC Reference

- - + +

Wallet Gateway

- - + +

Operation-first JSON-RPC reference pages with version history carried from the snapshot lifecycle report.

- - + +
- + OpenRPC - - 0.25.0 - + + 1.4.0 +
- +
- +
Publish version
-
0.25.0
+
1.4.0
- +
Versions compared
-
0.24.0, 0.25.0
+
0.24.0, 0.25.0, 0.26.0, 0.27.0, 1.1.0, 1.2.0, 1.2.1, 1.3.0, 1.4.0
- +
Source
-
Wallet Gateway OpenRPC specs from wallet-gateway-remote releases
+
splice-wallet-kernel Wallet Gateway OpenRPC specs from wallet-gateway-remote releases
- +
Version filter
@canton-network/wallet-gateway-remote@ GitHub releases
- +
@@ -58,173 +58,179 @@ Choose a spec page to browse its methods, then drill into operation pages for re
- - + + - +

Sync dApp API

- +
- + JSON-RPC - + Since 0.24.0 - + + Changed 1.4.0 +
- +

An OpenRPC specification for the dapp to interact with a Wallet Provider.

- - + +
- +
Methods
-
12
+
14
- +
Latest version
-
0.25.0
+
1.4.0
- +
OpenRPC
1.2.6
- +
- +
- - - + + + - +

Async dApp API

- +
- + JSON-RPC - + Since 0.24.0 - + + Changed 1.4.0 +
- +

An OpenRPC specification for remotely hosted Wallet Providers. Due to the remote nature, an implementing provider must bridge certain functionality on the client-side to satisfy the general dApp AP...

- - + +
- +
Methods
-
13
+
15
- +
Latest version
-
0.25.0
+
1.4.0
- +
OpenRPC
1.2.6
- +
- +
- - - + + + - +

Signing API

- +
- + JSON-RPC - + Since 0.24.0 - +
- +

An OpenRPC specification for the Signing API which allows the Wallet Gateway to interact with a Wallet Providers.

- - + +
- +
Methods
-
8
+
9
- +
Latest version
-
0.25.0
+
1.4.0
- +
OpenRPC
1.2.6
- +
- +
- - - + + + - +

User API

- +
- + JSON-RPC - + Since 0.24.0 - + + Changed 1.4.0 +
- +

An OpenRPC specification for the user to interact with the Wallet Gateway.

- - + +
- +
Methods
-
22
+
28
- +
Latest version
-
0.25.0
+
1.4.0
- +
OpenRPC
1.2.6
- +
- +
- - + +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/operations/signing-api/createkey.mdx b/docs-main/reference/wallet-gateway-json-rpc/operations/signing-api/createkey.mdx index 0e74f165c..d429dd6b5 100644 --- a/docs-main/reference/wallet-gateway-json-rpc/operations/signing-api/createkey.mdx +++ b/docs-main/reference/wallet-gateway-json-rpc/operations/signing-api/createkey.mdx @@ -9,53 +9,53 @@ title: "createKey"
- +

Signing API

- - + +

createKey

- - - + + +
- + JSON-RPC - + Since 0.24.0 - +
- +
- + POST - + JSON-RPC createKey
@@ -63,32 +63,32 @@ title: "createKey"
- +
Protocol
JSON-RPC
- +
Transport
HTTP POST
- +
Method
createKey
- +
Parameters
1
- +
Result
oneOf
- +
@@ -98,47 +98,47 @@ title: "createKey"

params

- +
- - - + + +
- +
Shape
object
- +
Required
name
- +
- - - + + +
- +
name string - + required - +
- +
- +
- - - - + + + +
@@ -148,49 +148,49 @@ title: "createKey"

result

- +
- - - + + +
- +
Shape
oneOf
- +
- - - + + +
- +
error string - +
- +
- +
error_description string - +
- +
- +
- - - - + + + +
@@ -205,56 +205,56 @@ title: "createKey"
- - + +
- +
name string - + required - +
- +
- +
- - + +
- - + +
- +
error string - +
- +
- +
error_description string - +
- +
- +
- - + +
@@ -264,12 +264,12 @@ title: "createKey"
- +
cURL - +
```bash cURL @@ -292,14 +292,14 @@ EOF
- +
Result - + application/json - +
```json Result @@ -311,7 +311,7 @@ EOF
- +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/operations/signing-api/details.mdx b/docs-main/reference/wallet-gateway-json-rpc/operations/signing-api/details.mdx index 4b23038e0..bb683de1b 100644 --- a/docs-main/reference/wallet-gateway-json-rpc/operations/signing-api/details.mdx +++ b/docs-main/reference/wallet-gateway-json-rpc/operations/signing-api/details.mdx @@ -1,55 +1,52 @@ --- title: "Details and history" +description: "An OpenRPC specification for the Signing API which allows the Wallet Gateway to interact with a Wallet Providers." --- -
+

Back to overview

-
-
+
+

OpenRPC Spec

-
- -

openrpc spec

- -

Signing API

-

Details and history

-

An OpenRPC specification for the Signing API which allows the Wallet Gateway to interact with a Wallet Providers.

- -
- - JSON-RPC - - Since 0.24.0 - -
-
-
+

Signing API

+ + +

An OpenRPC specification for the Signing API which allows the Wallet Gateway to interact with a Wallet Providers.

+ + +
+ + JSON-RPC + + Since 0.24.0 + +
+ -
- +
Latest source path
api-specs/openrpc-signing-api.json
- +
Publish version
-
0.25.0
+
1.4.0
- +
OpenRPC version
1.2.6
- +
Spec info.version
0.1.0
- +
@@ -63,299 +60,336 @@ Method pages are the primary reference surface. This spec page stays focused on
- - + + - +

createKey

- +
- + JSON-RPC - + Since 0.24.0 - +
- +

Create a new key at the Wallet Provider.

- - + +
- +
Parameters
1
- +
Result
oneOf
- +
- +
- - - + + + - +

getConfiguration

- +
- + JSON-RPC - + Since 0.24.0 - +
- - + +
- +
Parameters
0
- +
Result
object
- +
- +
- - - + + + - +

getKeys

- +
- + JSON-RPC - + Since 0.24.0 - +
- +

Get a list of public keys availabile for signing.

- - + +
- +
Parameters
0
- +
Result
oneOf
- +
- +
- - - + + + - +

getTransaction

- +
- + JSON-RPC - + Since 0.24.0 - +
- +

Get the status of a single transaction by its ID.

- - + +
- +
Parameters
1
- +
Result
oneOf
- +
- +
- - - + + + - +

getTransactions

- +
- + JSON-RPC - + Since 0.24.0 - +
- +

Get the status of multiple transactions, filtering by txIds or publicKeys. Either publicKeys or txIds must be provided.

- - + +
- +
Parameters
1
- +
Result
oneOf
- +
- +
- - - + + + - +

setConfiguration

- +
- + JSON-RPC - + Since 0.24.0 - +
- +

Set configuration parameters for the Wallet Provider. The paramaters will change depending on the Wallet Provider implementation

- - + +
- +
Parameters
1
- +
Result
object
- + +
+ + +
+ + + + + +
+

signMessage

+ +
+ + JSON-RPC + + Since 1.4.0 + +
+ +
+ +

Signs an arbitrary UTF-8 message with the wallet's private key (Ed25519). The message bytes are signed as-is; callers are expected to embed any application-level domai...

+ + +
+ +
+
Parameters
+
1
+
+ +
+
Result
+
oneOf
+
+
- +
- - - + + + - +

signTransaction

- +
- + JSON-RPC - + Since 0.24.0 - +
- +

Uses the Wallet Provider to sign a transaction. This will likely be an asynchronous operation.

- - + +
- +
Parameters
1
- +
Result
oneOf
- +
- +
- - - + + + - +

subscribeTransactions

- +
- + JSON-RPC - + Since 0.24.0 - +
- +

Subscribe to updates for specific transactions. The server will emit updates when the status of the specified transactions have changed. On initial subscription, the s...

- - + +
- +
Parameters
1
- +
Result
object
- +
- +
- - + +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/operations/signing-api/getconfiguration.mdx b/docs-main/reference/wallet-gateway-json-rpc/operations/signing-api/getconfiguration.mdx index d3f4496ff..d78651340 100644 --- a/docs-main/reference/wallet-gateway-json-rpc/operations/signing-api/getconfiguration.mdx +++ b/docs-main/reference/wallet-gateway-json-rpc/operations/signing-api/getconfiguration.mdx @@ -9,53 +9,53 @@ title: "getConfiguration"
- +

Signing API

- - + +

getConfiguration

- - - + + +
- + JSON-RPC - + Since 0.24.0 - +
- +
- + POST - + JSON-RPC getConfiguration
@@ -63,32 +63,32 @@ title: "getConfiguration"
- +
Protocol
JSON-RPC
- +
Transport
HTTP POST
- +
Method
getConfiguration
- +
Parameters
0
- +
Result
object
- +
@@ -102,27 +102,27 @@ title: "getConfiguration"

result

- +
- - - + + +
- +
Shape
object
- +
- - - - - - - + + + + + + +
@@ -137,10 +137,10 @@ title: "getConfiguration"
- - - - + + + +
@@ -150,12 +150,12 @@ title: "getConfiguration"
- +
cURL - +
```bash cURL @@ -173,14 +173,14 @@ EOF
- +
Result - + application/json - +
```json Result @@ -189,7 +189,7 @@ EOF
- +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/operations/signing-api/getkeys.mdx b/docs-main/reference/wallet-gateway-json-rpc/operations/signing-api/getkeys.mdx index 95b7b758d..bb392c738 100644 --- a/docs-main/reference/wallet-gateway-json-rpc/operations/signing-api/getkeys.mdx +++ b/docs-main/reference/wallet-gateway-json-rpc/operations/signing-api/getkeys.mdx @@ -9,53 +9,53 @@ title: "getKeys"
- +

Signing API

- - + +

getKeys

- - - + + +
- + JSON-RPC - + Since 0.24.0 - +
- +
- + POST - + JSON-RPC getKeys
@@ -63,32 +63,32 @@ title: "getKeys"
- +
Protocol
JSON-RPC
- +
Transport
HTTP POST
- +
Method
getKeys
- +
Parameters
0
- +
Result
oneOf
- +
@@ -102,49 +102,49 @@ title: "getKeys"

result

- +
- - - + + +
- +
Shape
oneOf
- +
- - - + + +
- +
error string - +
- +
- +
error_description string - +
- +
- +
- - - - + + + +
@@ -159,32 +159,32 @@ title: "getKeys"
- - + +
- +
error string - +
- +
- +
error_description string - +
- +
- +
- - + +
@@ -194,12 +194,12 @@ title: "getKeys"
- +
cURL - +
```bash cURL @@ -217,14 +217,14 @@ EOF
- +
Result - + application/json - +
```json Result @@ -236,7 +236,7 @@ EOF
- +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/operations/signing-api/gettransaction.mdx b/docs-main/reference/wallet-gateway-json-rpc/operations/signing-api/gettransaction.mdx index 33f4ae21e..ebee069eb 100644 --- a/docs-main/reference/wallet-gateway-json-rpc/operations/signing-api/gettransaction.mdx +++ b/docs-main/reference/wallet-gateway-json-rpc/operations/signing-api/gettransaction.mdx @@ -9,53 +9,53 @@ title: "getTransaction"
- +

Signing API

- - + +

getTransaction

- - - + + +
- + JSON-RPC - + Since 0.24.0 - +
- +
- + POST - + JSON-RPC getTransaction
@@ -63,32 +63,32 @@ title: "getTransaction"
- +
Protocol
JSON-RPC
- +
Transport
HTTP POST
- +
Method
getTransaction
- +
Parameters
1
- +
Result
oneOf
- +
@@ -98,47 +98,47 @@ title: "getTransaction"

params

- +
- - - + + +
- +
Shape
object
- +
Required
txId
- +
- - - + + +
- +
txId string - + required - +
- +
- +
- - - - + + + +
@@ -148,49 +148,49 @@ title: "getTransaction"

result

- +
- - - + + +
- +
Shape
oneOf
- +
- - - + + +
- +
error string - +
- +
- +
error_description string - +
- +
- +
- - - - + + + +
@@ -205,56 +205,56 @@ title: "getTransaction"
- - + +
- +
txId string - + required - +
- +
- +
- - + +
- - + +
- +
error string - +
- +
- +
error_description string - +
- +
- +
- - + +
@@ -264,12 +264,12 @@ title: "getTransaction"
- +
cURL - +
```bash cURL @@ -292,14 +292,14 @@ EOF
- +
Result - + application/json - +
```json Result @@ -311,7 +311,7 @@ EOF
- +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/operations/signing-api/gettransactions.mdx b/docs-main/reference/wallet-gateway-json-rpc/operations/signing-api/gettransactions.mdx index 06030bc6e..ad9653ccd 100644 --- a/docs-main/reference/wallet-gateway-json-rpc/operations/signing-api/gettransactions.mdx +++ b/docs-main/reference/wallet-gateway-json-rpc/operations/signing-api/gettransactions.mdx @@ -9,53 +9,53 @@ title: "getTransactions"
- +

Signing API

- - + +

getTransactions

- - - + + +
- + JSON-RPC - + Since 0.24.0 - +
- +
- + POST - + JSON-RPC getTransactions
@@ -63,32 +63,32 @@ title: "getTransactions"
- +
Protocol
JSON-RPC
- +
Transport
HTTP POST
- +
Method
getTransactions
- +
Parameters
1
- +
Result
oneOf
- +
@@ -98,49 +98,49 @@ title: "getTransactions"

params

- +
- - - + + +
- +
Shape
object
- +
- - - + + +
- +
txIds array[string] - +
- +
- +
publicKeys array[string] - +
- +
- +
- - - - + + + +
@@ -150,49 +150,49 @@ title: "getTransactions"

result

- +
- - - + + +
- +
Shape
oneOf
- +
- - - + + +
- +
error string - +
- +
- +
error_description string - +
- +
- +
- - - - + + + +
@@ -207,63 +207,63 @@ title: "getTransactions"
- - + +
- +
txIds array[string] - +
- +
- +
publicKeys array[string] - +
- +
- +
- - + +
- - + +
- +
error string - +
- +
- +
error_description string - +
- +
- +
- - + +
@@ -273,12 +273,12 @@ title: "getTransactions"
- +
cURL - +
```bash cURL @@ -306,14 +306,14 @@ EOF
- +
Result - + application/json - +
```json Result @@ -325,7 +325,7 @@ EOF
- +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/operations/signing-api/setconfiguration.mdx b/docs-main/reference/wallet-gateway-json-rpc/operations/signing-api/setconfiguration.mdx index 65befa6ee..ec860eb03 100644 --- a/docs-main/reference/wallet-gateway-json-rpc/operations/signing-api/setconfiguration.mdx +++ b/docs-main/reference/wallet-gateway-json-rpc/operations/signing-api/setconfiguration.mdx @@ -9,53 +9,53 @@ title: "setConfiguration"
- +

Signing API

- - + +

setConfiguration

- - - + + +
- + JSON-RPC - + Since 0.24.0 - +
- +
- + POST - + JSON-RPC setConfiguration
@@ -63,32 +63,32 @@ title: "setConfiguration"
- +
Protocol
JSON-RPC
- +
Transport
HTTP POST
- +
Method
setConfiguration
- +
Parameters
1
- +
Result
object
- +
@@ -98,27 +98,27 @@ title: "setConfiguration"

params

- +
- - - + + +
- +
Shape
object
- +
- - - - - - - + + + + + + +
@@ -128,27 +128,27 @@ title: "setConfiguration"

result

- +
- - - + + +
- +
Shape
object
- +
- - - - - - - + + + + + + +
@@ -163,19 +163,19 @@ title: "setConfiguration"
- - - - + + + +
- - - - + + + +
@@ -185,12 +185,12 @@ title: "setConfiguration"
- +
cURL - +
```bash cURL @@ -211,14 +211,14 @@ EOF
- +
Result - + application/json - +
```json Result @@ -227,7 +227,7 @@ EOF
- +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/operations/signing-api/signmessage.mdx b/docs-main/reference/wallet-gateway-json-rpc/operations/signing-api/signmessage.mdx new file mode 100644 index 000000000..4d1619065 --- /dev/null +++ b/docs-main/reference/wallet-gateway-json-rpc/operations/signing-api/signmessage.mdx @@ -0,0 +1,317 @@ +--- +title: "signMessage" +--- + +
+ +
+
+ + + + + +
+ +

Signing API

+ + +

signMessage

+ + + +
+ + JSON-RPC + + Since 1.4.0 + +
+ + +
+ +
+ + POST + + JSON-RPC signMessage +
+ +## Protocol Details + + +
+ +
+
Protocol
+
JSON-RPC
+
+ +
+
Transport
+
HTTP POST
+
+ +
+
Method
+
signMessage
+
+ +
+
Parameters
+
1
+
+ +
+
Result
+
oneOf
+
+ +
+ + +## Inputs + + +
+
+

params

+ +
+ + + +
+ +
+
Shape
+
object
+
+ +
+
Required
+
message
+
+ +
+ + + + +
+ +
+
+ message + string + + required + +
+ +
+ +
+ + + + + +
+ + +## Outputs + + +
+
+

result

+ +
+ + + +
+ +
+
Shape
+
oneOf
+
+ +
+ + + + +
+ +
+
+ error + string + +
+ +
+ +
+
+ error_description + string + +
+ +
+ +
+ + + + + +
+ + + + + + + +## Related Schemas + + + + +
+ + +
+ +
+
+ message + string + + required + +
+ +
+ +
+ + + +
+
+ + +
+ + +
+ +
+
+ error + string + +
+ +
+ +
+
+ error_description + string + +
+ +
+ +
+ + + +
+
+ +
+ + +
+ +
+ +
+
+
+ cURL + +
+ +```bash cURL +curl \ + \ + -H 'content-type: application/json' \ + --data @- <<'EOF' +{ + "jsonrpc": "2.0", + "id": 1, + "method": "signMessage", + "params": { + "params": { + "message": "" + } + } +} +EOF +``` + +
+
+ +
+
+
+ Result + + application/json + +
+ +```json Result +{ + "error": "", + "error_description": "" +} +``` + +
+
+ +
+ +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/operations/signing-api/signtransaction.mdx b/docs-main/reference/wallet-gateway-json-rpc/operations/signing-api/signtransaction.mdx index e14462c2c..29aa6329b 100644 --- a/docs-main/reference/wallet-gateway-json-rpc/operations/signing-api/signtransaction.mdx +++ b/docs-main/reference/wallet-gateway-json-rpc/operations/signing-api/signtransaction.mdx @@ -9,53 +9,53 @@ title: "signTransaction"
- +

Signing API

- - + +

signTransaction

- - - + + +
- + JSON-RPC - + Since 0.24.0 - +
- +
- + POST - + JSON-RPC signTransaction
@@ -63,32 +63,32 @@ title: "signTransaction"
- +
Protocol
JSON-RPC
- +
Transport
HTTP POST
- +
Method
signTransaction
- +
Parameters
1
- +
Result
oneOf
- +
@@ -98,69 +98,69 @@ title: "signTransaction"

params

- +
- - - + + +
- +
Shape
object
- +
Required
keyIdentifier, tx, txHash
- +
- - - + + +
- +
tx string - + required - +
- +
- +
txHash string - + required - +
- +
- +
keyIdentifier object - + required - +
- +
- +
- - - - + + + +
@@ -170,49 +170,49 @@ title: "signTransaction"

result

- +
- - - + + +
- +
Shape
oneOf
- +
- - - + + +
- +
error string - +
- +
- +
error_description string - +
- +
- +
- - - - + + + +
@@ -227,78 +227,78 @@ title: "signTransaction"
- - + +
- +
tx string - + required - +
- +
- +
txHash string - + required - +
- +
- +
keyIdentifier object - + required - +
- +
- +
- - + +
- - + +
- +
error string - +
- +
- +
error_description string - +
- +
- +
- - + +
@@ -308,12 +308,12 @@ title: "signTransaction"
- +
cURL - +
```bash cURL @@ -340,14 +340,14 @@ EOF
- +
Result - + application/json - +
```json Result @@ -359,7 +359,7 @@ EOF
- +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/operations/signing-api/subscribetransactions.mdx b/docs-main/reference/wallet-gateway-json-rpc/operations/signing-api/subscribetransactions.mdx index 9ede58a5a..c095b79e2 100644 --- a/docs-main/reference/wallet-gateway-json-rpc/operations/signing-api/subscribetransactions.mdx +++ b/docs-main/reference/wallet-gateway-json-rpc/operations/signing-api/subscribetransactions.mdx @@ -9,53 +9,53 @@ title: "subscribeTransactions"
- +

Signing API

- - + +

subscribeTransactions

- - - + + +
- + JSON-RPC - + Since 0.24.0 - +
- +
- + POST - + JSON-RPC subscribeTransactions
@@ -63,32 +63,32 @@ title: "subscribeTransactions"
- +
Protocol
JSON-RPC
- +
Transport
HTTP POST
- +
Method
subscribeTransactions
- +
Parameters
1
- +
Result
object
- +
@@ -98,47 +98,47 @@ title: "subscribeTransactions"

params

- +
- - - + + +
- +
Shape
object
- +
Required
txIds
- +
- - - + + +
- +
txIds array[string] - + required - +
- +
- +
- - - - + + + +
@@ -148,63 +148,63 @@ title: "subscribeTransactions"

result

- +
- - - + + +
- +
Shape
object
- +
Schema
Transaction
- +
Required
status, txId
- +
- - - + + +
- +
txId string - + required - +
- +
- +
status string - + required - +
- +
- +
- - - - + + + +
@@ -219,60 +219,60 @@ title: "subscribeTransactions"
- - + +
- +
txIds array[string] - + required - +
- +
- +
- - + +
- - + +
- +
txId string - + required - +
- +
- +
status string - + required - +
- +
- +
- - + +
@@ -282,12 +282,12 @@ title: "subscribeTransactions"
- +
cURL - +
```bash cURL @@ -312,14 +312,14 @@ EOF
- +
Result - + application/json - +
```json Result @@ -331,7 +331,7 @@ EOF
- +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/addidp.mdx b/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/addidp.mdx index f944e9790..77649cdf0 100644 --- a/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/addidp.mdx +++ b/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/addidp.mdx @@ -9,53 +9,53 @@ title: "addIdp"
- +

User API

- - + +

addIdp

- - - + + +
- + JSON-RPC - + Since 0.24.0 - +
- +
- + POST - + JSON-RPC addIdp
@@ -63,32 +63,32 @@ title: "addIdp"
- +
Protocol
JSON-RPC
- +
Transport
HTTP POST
- +
Method
addIdp
- +
Parameters
1
- +
Result
null
- +
@@ -98,47 +98,47 @@ title: "addIdp"

params

- +
- - - + + +
- +
Shape
object
- +
Required
idp
- +
- - - + + +
- +
idp object - + required - +
- +
- +
- - - - + + + +
@@ -148,32 +148,32 @@ title: "addIdp"

result

- +
- - - + + +
- +
Shape
null
- +
Schema
Null
- +
- - - - - - - + + + + + + +
@@ -188,34 +188,34 @@ title: "addIdp"
- - + +
- +
idp object - + required - +
- +
- +
- - + +
- - - - + + + +
@@ -225,12 +225,12 @@ title: "addIdp"
- +
cURL - +
```bash cURL @@ -257,14 +257,14 @@ EOF
- +
Result - + application/json - +
```json Result @@ -273,7 +273,7 @@ EOF
- +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/addnetwork.mdx b/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/addnetwork.mdx index 5769f3493..6d8b82a24 100644 --- a/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/addnetwork.mdx +++ b/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/addnetwork.mdx @@ -9,53 +9,53 @@ title: "addNetwork"
- +

User API

- - + +

addNetwork

- - - + + +
- + JSON-RPC - + Since 0.24.0 - +
- +
- + POST - + JSON-RPC addNetwork
@@ -63,32 +63,32 @@ title: "addNetwork"
- +
Protocol
JSON-RPC
- +
Transport
HTTP POST
- +
Method
addNetwork
- +
Parameters
1
- +
Result
null
- +
@@ -98,47 +98,47 @@ title: "addNetwork"

params

- +
- - - + + +
- +
Shape
object
- +
Required
network
- +
- - - + + +
- +
network object - + required - +
- +
- +
- - - - + + + +
@@ -148,32 +148,32 @@ title: "addNetwork"

result

- +
- - - + + +
- +
Shape
null
- +
Schema
Null
- +
- - - - - - - + + + + + + +
@@ -188,34 +188,34 @@ title: "addNetwork"
- - + +
- +
network object - + required - +
- +
- +
- - + +
- - - - + + + +
@@ -225,12 +225,12 @@ title: "addNetwork"
- +
cURL - +
```bash cURL @@ -265,14 +265,14 @@ EOF
- +
Result - + application/json - +
```json Result @@ -281,7 +281,7 @@ EOF
- +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/addsession.mdx b/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/addsession.mdx index a5c3f6208..c04aedb43 100644 --- a/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/addsession.mdx +++ b/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/addsession.mdx @@ -9,53 +9,53 @@ title: "addSession"
- +

User API

- - + +

addSession

- - - + + +
- + JSON-RPC - + Since 0.24.0 - +
- +
- + POST - + JSON-RPC addSession
@@ -63,32 +63,32 @@ title: "addSession"
- +
Protocol
JSON-RPC
- +
Transport
HTTP POST
- +
Method
addSession
- +
Parameters
1
- +
Result
object
- +
@@ -98,47 +98,47 @@ title: "addSession"

params

- +
- - - + + +
- +
Shape
object
- +
Required
networkId
- +
- - - + + +
- +
networkId string - + required - +
- +
- +
- - - - + + + +
@@ -148,107 +148,107 @@ title: "addSession"

result

- +
- - - + + +
- +
Shape
object
- +
Schema
Session
- +
Required
accessToken, id, idp, network, rights, status
- +
- - - + + +
- +
id string - + required - +
- +
- +
network object - + required - +
- +
- +
idp object - + required - +
- +
- +
accessToken string - + required - +
- +
- +
status string - + required - +
- +
- +
rights array[string] - + required - +
- +
- +
- - - - + + + +
@@ -263,104 +263,104 @@ title: "addSession"
- - + +
- +
networkId string - + required - +
- +
- +
- - + +
- - + +
- +
id string - + required - +
- +
- +
network object - + required - +
- +
- +
idp object - + required - +
- +
- +
accessToken string - + required - +
- +
- +
status string - + required - +
- +
- +
rights array[string] - + required - +
- +
- +
- - + +
@@ -370,12 +370,12 @@ title: "addSession"
- +
cURL - +
```bash cURL @@ -398,14 +398,14 @@ EOF
- +
Result - + application/json - +
```json Result @@ -439,7 +439,7 @@ EOF
- +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/allocatepartyforwallet.mdx b/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/allocatepartyforwallet.mdx index e099ae814..fd88951d7 100644 --- a/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/allocatepartyforwallet.mdx +++ b/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/allocatepartyforwallet.mdx @@ -9,53 +9,53 @@ title: "allocatePartyForWallet"
- +

User API

- - + +

allocatePartyForWallet

- - - + + +
- + JSON-RPC - + Since 0.24.0 - +
- +
- + POST - + JSON-RPC allocatePartyForWallet
@@ -63,32 +63,32 @@ title: "allocatePartyForWallet"
- +
Protocol
JSON-RPC
- +
Transport
HTTP POST
- +
Method
allocatePartyForWallet
- +
Parameters
1
- +
Result
object
- +
@@ -98,47 +98,47 @@ title: "allocatePartyForWallet"

params

- +
- - - + + +
- +
Shape
object
- +
Required
partyId
- +
- - - + + +
- +
partyId string - + required - +
- +
- +
- - - - + + + +
@@ -148,47 +148,47 @@ title: "allocatePartyForWallet"

result

- +
- - - + + +
- +
Shape
object
- +
Required
wallet
- +
- - - + + +
- +
wallet object - + required - +
- +
- +
- - - - + + + +
@@ -203,49 +203,49 @@ title: "allocatePartyForWallet"
- - + +
- +
partyId string - + required - +
- +
- +
- - + +
- - + +
- +
wallet object - + required - +
- +
- +
- - + +
@@ -255,12 +255,12 @@ title: "allocatePartyForWallet"
- +
cURL - +
```bash cURL @@ -283,14 +283,14 @@ EOF
- +
Result - + application/json - +
```json Result @@ -310,7 +310,7 @@ EOF
- +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/createwallet.mdx b/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/createwallet.mdx index d15a533b9..f1ebc4503 100644 --- a/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/createwallet.mdx +++ b/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/createwallet.mdx @@ -9,53 +9,53 @@ title: "createWallet"
- +

User API

- - + +

createWallet

- - - + + +
- + JSON-RPC - + Since 0.24.0 - +
- +
- + POST - + JSON-RPC createWallet
@@ -63,32 +63,32 @@ title: "createWallet"
- +
Protocol
JSON-RPC
- +
Transport
HTTP POST
- +
Method
createWallet
- +
Parameters
1
- +
Result
object
- +
@@ -98,58 +98,58 @@ title: "createWallet"

params

- +
- - - + + +
- +
Shape
object
- +
Required
partyHint, signingProviderId, networkId
- +
- - - + + +
- +
partyHint string - + required - +
- +
- +
signingProviderId string - + required - +
- +
- +
- - - - + + + +
@@ -159,47 +159,47 @@ title: "createWallet"

result

- +
- - - + + +
- +
Shape
object
- +
Required
wallet
- +
- - - + + +
- +
wallet object - + required - +
- +
- +
- - - - + + + +
@@ -214,60 +214,60 @@ title: "createWallet"
- - + +
- +
partyHint string - + required - +
- +
- +
signingProviderId string - + required - +
- +
- +
- - + +
- - + +
- +
wallet object - + required - +
- +
- +
- - + +
@@ -277,12 +277,12 @@ title: "createWallet"
- +
cURL - +
```bash cURL @@ -306,14 +306,14 @@ EOF
- +
Result - + application/json - +
```json Result @@ -333,7 +333,7 @@ EOF
- +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/deletemessagetosign.mdx b/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/deletemessagetosign.mdx new file mode 100644 index 000000000..0cb68a57d --- /dev/null +++ b/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/deletemessagetosign.mdx @@ -0,0 +1,275 @@ +--- +title: "deleteMessageToSign" +--- + +
+ +
+
+ + + + + +
+ +

User API

+ + +

deleteMessageToSign

+ + + +
+ + JSON-RPC + + Since 1.4.0 + +
+ + +
+ +
+ + POST + + JSON-RPC deleteMessageToSign +
+ +## Protocol Details + + +
+ +
+
Protocol
+
JSON-RPC
+
+ +
+
Transport
+
HTTP POST
+
+ +
+
Method
+
deleteMessageToSign
+
+ +
+
Parameters
+
1
+
+ +
+
Result
+
null
+
+ +
+ + +## Inputs + + +
+
+

params

+ +
+ + + +
+ +
+
Shape
+
object
+
+ +
+
Required
+
messageId
+
+ +
+ + + + +
+ +
+
+ messageId + string + + required + +
+ +
+ +
+ + + + + +
+ + +## Outputs + + +
+
+

result

+ +
+ + + +
+ +
+
Shape
+
null
+
+ +
+
Schema
+
Null
+
+ +
+ + + + + + + + +
+ + + + + + + +## Related Schemas + + + + +
+ + +
+ +
+
+ messageId + string + + required + +
+ +
+ +
+ + + +
+
+ + +
+ + + + +
+
+ +
+ + +
+ +
+ +
+
+
+ cURL + +
+ +```bash cURL +curl \ + \ + -H 'content-type: application/json' \ + --data @- <<'EOF' +{ + "jsonrpc": "2.0", + "id": 1, + "method": "deleteMessageToSign", + "params": { + "params": { + "messageId": "" + } + } +} +EOF +``` + +
+
+ +
+
+
+ Result + + application/json + +
+ +```json Result +"" +``` + +
+
+ +
+ +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/deletetransaction.mdx b/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/deletetransaction.mdx index 61285f874..89873cf01 100644 --- a/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/deletetransaction.mdx +++ b/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/deletetransaction.mdx @@ -9,53 +9,55 @@ title: "deleteTransaction"
- +

User API

- - + +

deleteTransaction

- - - + + +
- + JSON-RPC - + Since 0.24.0 - + + Changed 0.27.0 +
- +
- + POST - + JSON-RPC deleteTransaction
@@ -63,32 +65,32 @@ title: "deleteTransaction"
- +
Protocol
JSON-RPC
- +
Transport
HTTP POST
- +
Method
deleteTransaction
- +
Parameters
1
- +
Result
null
- +
@@ -98,47 +100,47 @@ title: "deleteTransaction"

params

- +
- - - + + +
- +
Shape
object
- +
Required
-
commandId
+
transactionId
- +
- - - + + +
- +
- commandId + transactionId string - + required - +
- +
- +
- - - - + + + +
@@ -148,38 +150,49 @@ title: "deleteTransaction"

result

- +
- - - + + +
- +
Shape
null
- +
Schema
Null
- +
- - - - - - - + + + + + + +
+## Lifecycle Changes + +
+ +
+ 0.27.0 + params updated: `params` +
+ +
+ ## Related Schemas @@ -188,34 +201,34 @@ title: "deleteTransaction"
- - + +
- +
- commandId + transactionId string - + required - +
- +
- +
- - + +
- - - - + + + +
@@ -225,12 +238,12 @@ title: "deleteTransaction"
- +
cURL - +
```bash cURL @@ -244,7 +257,7 @@ curl \ "method": "deleteTransaction", "params": { "params": { - "commandId": "" + "transactionId": "" } } } @@ -253,14 +266,14 @@ EOF
- +
Result - + application/json - +
```json Result @@ -269,7 +282,7 @@ EOF
- +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/details.mdx b/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/details.mdx index 2d5c2fad2..cc373effb 100644 --- a/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/details.mdx +++ b/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/details.mdx @@ -1,55 +1,54 @@ --- title: "Details and history" +description: "An OpenRPC specification for the user to interact with the Wallet Gateway." --- -
+

Back to overview

-
-
+
+

OpenRPC Spec

-
- -

openrpc spec

- -

User API

-

Details and history

-

An OpenRPC specification for the user to interact with the Wallet Gateway.

- -
- - JSON-RPC - - Since 0.24.0 - -
-
-
+

User API

+ + +

An OpenRPC specification for the user to interact with the Wallet Gateway.

+ + +
+ + JSON-RPC + + Since 0.24.0 + + Changed 1.4.0 + +
+ -
- +
Latest source path
api-specs/openrpc-user-api.json
- +
Publish version
-
0.25.0
+
1.4.0
- +
OpenRPC version
1.2.6
- +
Spec info.version
0.1.0
- +
@@ -63,809 +62,1043 @@ Method pages are the primary reference surface. This spec page stays focused on
- - + + - +

addIdp

- +
- + JSON-RPC - + Since 0.24.0 - +
- +

Adds a new identity provider.

- - + +
- +
Parameters
1
- +
Result
null
- +
- +
- - - + + + - +

addNetwork

- +
- + JSON-RPC - + Since 0.24.0 - +
- +

Adds a new network configuration (similar to EIP-3085).

- - + +
- +
Parameters
1
- +
Result
null
- +
- +
- - - + + + - +

addSession

- +
- + JSON-RPC - + Since 0.24.0 - +
- +

Adds a network session.

- - + +
- +
Parameters
1
- +
Result
object
- +
- +
- - - + + + - +

allocatePartyForWallet

- +
- + JSON-RPC - + Since 0.24.0 - +
- +

Allocates a party for an already initialized wallet if external signing is complete.

- - + +
- +
Parameters
1
- +
Result
object
- +
- +
- - - + + + - +

createWallet

- +
- + JSON-RPC - + Since 0.24.0 - +
- +

Creates a new wallet and party with the given hint.

- - + +
- +
Parameters
1
- +
Result
object
- +
- +
- - - - - + + + + +
-

deleteTransaction

- +

deleteMessageToSign

+
- + JSON-RPC - - Since 0.24.0 - + + Since 1.4.0 +
- -

Deletes a pending transaction. Only transactions with status 'pending' can be deleted.

- - + +

Rejects a pending message signing request.

+ +
- +
Parameters
1
- +
Result
null
- +
- +
- - - - - + + + + +
-

execute

- +

deleteTransaction

+
- + JSON-RPC - + Since 0.24.0 - + + Changed 0.27.0 +
- -

Executes a signed transaction.

- - + +

Deletes a pending transaction. Only transactions with status 'pending' can be deleted.

+ +
- +
Parameters
1
- +
Result
-
object
+
null
- +
- +
- - - - - + + + + +
-

getTransaction

- +

execute

+
- + JSON-RPC - + Since 0.24.0 - + + Changed 0.27.0 +
- - + +

Executes a signed transaction.

+ +
- +
Parameters
1
- +
Result
object
- +
- +
- - - - - + + + + +
-

getUser

- +

getMessageToSign

+
- + JSON-RPC - - Since 0.24.0 - + + Since 1.4.0 +
- -

Returns information about the current user, including whether they are an admin.

- - + +

Gets a pending message signing request.

+ +
- +
Parameters
-
0
+
1
- +
Result
object
- +
- +
- - - - - + + + + +
-

isWalletSyncNeeded

- +

getNetwork

+
- + JSON-RPC - - Since 0.24.0 - + + Since 1.4.0 +
- -

Checks if wallet sync is needed (disabled wallets or new parties on ledger).

- - + +

Returns full network configuration including auth details. Admin only.

+ +
- +
Parameters
-
0
+
1
- +
Result
object
- +
- +
- - - - - + + + + +
-

listIdps

- +

getTransaction

+
- + JSON-RPC - + Since 0.24.0 - + + Changed 0.27.0 +
- - + +
- +
Parameters
-
0
+
1
- +
Result
object
- +
- +
- - - - - + + + + +
-

listNetworks

- +

getUser

+
- + JSON-RPC - + Since 0.24.0 - +
- - + +

Returns information about the current user, including whether they are an admin.

+ +
- +
Parameters
0
- +
Result
object
- +
- +
- - - - - + + + + +
-

listSessions

- +

isWalletSyncNeeded

+
- + JSON-RPC - + Since 0.24.0 - +
- - -
- -
-
Parameters
+ +

Checks if wallet sync is needed (disabled wallets or new parties on ledger).

+ + +
+ +
+
Parameters
0
- +
Result
object
- +
- +
- - - + + + + + +
+

listIdps

+ +
+ + JSON-RPC + + Since 0.24.0 + +
+ +
+ + +
+ +
+
Parameters
+
0
+
+ +
+
Result
+
object
+
+ +
+ + +
+ + + + + +
+

listMessagesToSign

+ +
+ + JSON-RPC + + Since 1.4.0 + +
+ +
+ + +
+ +
+
Parameters
+
0
+
+ +
+
Result
+
object
+
+ +
+ + +
+ + + + + +
+

listNetworks

+ +
+ + JSON-RPC + + Since 0.24.0 + + Changed 1.4.0 + +
+ +
+ +

Lists configured networks without sensitive authentication details.

+ + +
+ +
+
Parameters
+
0
+
+ +
+
Result
+
object
+
+ +
+ + +
+ + + + + +
+

listSessions

+ +
+ + JSON-RPC + + Since 0.24.0 + +
+ +
+ + +
+ +
+
Parameters
+
0
+
+ +
+
Result
+
object
+
+ +
+ + +
+ + + - +

listTransactions

- +
- + JSON-RPC - + Since 0.24.0 - + + Changed 0.27.0 +
- - + +
- +
Parameters
0
- +
Result
object
- +
- +
- - - + + + - +

listWallets

- +
- + JSON-RPC - + Since 0.24.0 - +
- +

Lists wallets.

- - + +
- +
Parameters
1
- +
Result
array[object]
- +
- +
- - - + + + - +

removeIdp

- +
- + JSON-RPC - + Since 0.24.0 - +
- +

Removes an identity provider. Fails if an existing network is using the identity provider.

- - + +
- +
Parameters
1
- +
Result
null
- +
- +
- - - + + + - +

removeNetwork

- +
- + JSON-RPC - + Since 0.24.0 - +
- +

Removes a new network configuration (similar to EIP-3085).

- - + +
- +
Parameters
1
- +
Result
null
- +
- +
- - - + + + - +

removeSession

- +
- + JSON-RPC - + Since 0.24.0 - +
- +

Removes the current network session.

- - + +
- +
Parameters
0
- +
Result
null
- +
- +
- - - + + + - +

removeWallet

- +
- + JSON-RPC - + Since 0.24.0 - +
- +

Removes a party with the given hint.

- - + +
- +
Parameters
1
- +
Result
object
- +
- +
- - - + + + + + +
+

selfSignedAccessToken

+ +
+ + JSON-RPC + + Since 1.4.0 + +
+ +
+ +

Mints a self-signed access token using server-side network credentials. Used for login on self-signed networks.

+ + +
+ +
+
Parameters
+
1
+
+ +
+
Result
+
object
+
+ +
+ + +
+ + + - +

setPrimaryWallet

- +
- + JSON-RPC - + Since 0.24.0 - +
- +

Sets the specified wallet as the primary wallet for dApp usage.

- - + +
- +
Parameters
1
- +
Result
null
- +
- +
- - - + + + - +

sign

- +
- + JSON-RPC - + Since 0.24.0 - + + Changed 0.27.0 +
- +

Signs the provided data with the private key of the specified or active party.

- - + +
- +
Parameters
1
- +
Result
oneOf
- + +
+ + +
+ + + + + +
+

signMessage

+ +
+ + JSON-RPC + + Since 1.4.0 + +
+ +
+ +

Signs an arbitrary UTF-8 message with the wallet's private key (Ed25519). The message bytes are signed as-is; callers are expected to embed any application-level domai...

+ + +
+ +
+
Parameters
+
1
+
+ +
+
Result
+
object
+
+
- +
- - - + + + - +

syncWallets

- +
- + JSON-RPC - + Since 0.24.0 - +
- +

Synchronizes wallets with the connected network.

- - + +
- +
Parameters
0
- +
Result
object
- +
- +
- - + +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/execute.mdx b/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/execute.mdx index 543547d2e..ec2842dba 100644 --- a/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/execute.mdx +++ b/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/execute.mdx @@ -9,53 +9,55 @@ title: "execute"
- +

User API

- - + +

execute

- - - + + +
- + JSON-RPC - + Since 0.24.0 - + + Changed 0.27.0 +
- +
- + POST - + JSON-RPC execute
@@ -63,32 +65,32 @@ title: "execute"
- +
Protocol
JSON-RPC
- +
Transport
HTTP POST
- +
Method
execute
- +
Parameters
1
- +
Result
object
- +
@@ -98,80 +100,80 @@ title: "execute"

params

- +
- - - + + +
- +
Shape
object
- +
Required
-
commandId, partyId, signature, signedBy
+
partyId, signature, signedBy, transactionId
- +
- - - + + +
- +
signature string - + required - +
- +
- +
partyId string - + required - +
- +
- +
- commandId + transactionId string - + required - +
- +
- +
signedBy string - + required - +
- +
- +
- - - - + + + +
@@ -181,33 +183,44 @@ title: "execute"

result

- +
- - - + + +
- +
Shape
object
- +
- - - - - - - + + + + + + +
+## Lifecycle Changes + +
+ +
+ 0.27.0 + params updated: `params` +
+ +
+ ## Related Schemas @@ -216,67 +229,67 @@ title: "execute"
- - + +
- +
signature string - + required - +
- +
- +
partyId string - + required - +
- +
- +
- commandId + transactionId string - + required - +
- +
- +
signedBy string - + required - +
- +
- +
- - + +
- - - - + + + +
@@ -286,12 +299,12 @@ title: "execute"
- +
cURL - +
```bash cURL @@ -307,7 +320,7 @@ curl \ "params": { "signature": "", "partyId": "", - "commandId": "", + "transactionId": "", "signedBy": "" } } @@ -317,14 +330,14 @@ EOF
- +
Result - + application/json - +
```json Result @@ -333,7 +346,7 @@ EOF
- +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/getmessagetosign.mdx b/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/getmessagetosign.mdx new file mode 100644 index 000000000..e9e27c21a --- /dev/null +++ b/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/getmessagetosign.mdx @@ -0,0 +1,314 @@ +--- +title: "getMessageToSign" +--- + +
+ +
+
+ + + + + +
+ +

User API

+ + +

getMessageToSign

+ + + +
+ + JSON-RPC + + Since 1.4.0 + +
+ + +
+ +
+ + POST + + JSON-RPC getMessageToSign +
+ +## Protocol Details + + +
+ +
+
Protocol
+
JSON-RPC
+
+ +
+
Transport
+
HTTP POST
+
+ +
+
Method
+
getMessageToSign
+
+ +
+
Parameters
+
1
+
+ +
+
Result
+
object
+
+ +
+ + +## Inputs + + +
+
+

params

+ +
+ + + +
+ +
+
Shape
+
object
+
+ +
+
Required
+
messageId
+
+ +
+ + + + +
+ +
+
+ messageId + string + + required + +
+ +
+ +
+ + + + + +
+ + +## Outputs + + +
+
+

result

+ +
+ + + +
+ +
+
Shape
+
object
+
+ +
+
Required
+
message
+
+ +
+ + + + +
+ +
+
+ message + object + + required + +
+ +
+ +
+ + + + + +
+ + + + + + + +## Related Schemas + + + + +
+ + +
+ +
+
+ messageId + string + + required + +
+ +
+ +
+ + + +
+
+ + +
+ + +
+ +
+
+ message + object + + required + +
+ +
+ +
+ + + +
+
+ +
+ + +
+ +
+ +
+
+
+ cURL + +
+ +```bash cURL +curl \ + \ + -H 'content-type: application/json' \ + --data @- <<'EOF' +{ + "jsonrpc": "2.0", + "id": 1, + "method": "getMessageToSign", + "params": { + "params": { + "messageId": "" + } + } +} +EOF +``` + +
+
+ +
+
+
+ Result + + application/json + +
+ +```json Result +{ + "message": { + "id": "", + "status": "", + "partyId": "", + "publicKey": "", + "message": "", + "createdAt": "" + } +} +``` + +
+
+ +
+ +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/getnetwork.mdx b/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/getnetwork.mdx new file mode 100644 index 000000000..960082205 --- /dev/null +++ b/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/getnetwork.mdx @@ -0,0 +1,319 @@ +--- +title: "getNetwork" +--- + +
+ +
+
+ + + + + +
+ +

User API

+ + +

getNetwork

+ + + +
+ + JSON-RPC + + Since 1.4.0 + +
+ + +
+ +
+ + POST + + JSON-RPC getNetwork +
+ +## Protocol Details + + +
+ +
+
Protocol
+
JSON-RPC
+
+ +
+
Transport
+
HTTP POST
+
+ +
+
Method
+
getNetwork
+
+ +
+
Parameters
+
1
+
+ +
+
Result
+
object
+
+ +
+ + +## Inputs + + +
+
+

params

+ +
+ + + +
+ +
+
Shape
+
object
+
+ +
+
Required
+
networkId
+
+ +
+ + + + +
+ +
+
+ networkId + string + + required + +
+ +
+ +
+ + + + + +
+ + +## Outputs + + +
+
+

result

+ +
+ + + +
+ +
+
Shape
+
object
+
+ +
+
Required
+
network
+
+ +
+ + + + +
+ +
+
+ network + object + + required + +
+ +
+ +
+ + + + + +
+ + + + + + + +## Related Schemas + + + + +
+ + +
+ +
+
+ networkId + string + + required + +
+ +
+ +
+ + + +
+
+ + +
+ + +
+ +
+
+ network + object + + required + +
+ +
+ +
+ + + +
+
+ +
+ + +
+ +
+ +
+
+
+ cURL + +
+ +```bash cURL +curl \ + \ + -H 'content-type: application/json' \ + --data @- <<'EOF' +{ + "jsonrpc": "2.0", + "id": 1, + "method": "getNetwork", + "params": { + "params": { + "networkId": "" + } + } +} +EOF +``` + +
+
+ +
+
+
+ Result + + application/json + +
+ +```json Result +{ + "network": { + "id": "", + "name": "", + "description": "", + "identityProviderId": "", + "auth": { + "method": "", + "scope": "", + "clientId": "", + "audience": "" + }, + "ledgerApi": "" + } +} +``` + +
+
+ +
+ +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/gettransaction.mdx b/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/gettransaction.mdx index 77afcf42c..c3242aecf 100644 --- a/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/gettransaction.mdx +++ b/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/gettransaction.mdx @@ -9,53 +9,55 @@ title: "getTransaction"
- +

User API

- - + +

getTransaction

- - - + + +
- + JSON-RPC - + Since 0.24.0 - + + Changed 0.27.0 +
- +
- + POST - + JSON-RPC getTransaction
@@ -63,32 +65,32 @@ title: "getTransaction"
- +
Protocol
JSON-RPC
- +
Transport
HTTP POST
- +
Method
getTransaction
- +
Parameters
1
- +
Result
object
- +
@@ -98,47 +100,47 @@ title: "getTransaction"

params

- +
- - - + + +
- +
Shape
object
- +
Required
-
commandId
+
transactionId
- +
- - - + + +
- +
- commandId + transactionId string - + required - +
- +
- +
- - - - + + + +
@@ -148,91 +150,113 @@ title: "getTransaction"

result

- +
- - - + + +
- +
Shape
object
- +
Schema
Transaction
- +
Required
-
commandId, preparedTransaction, preparedTransactionHash, status
+
commandId, id, preparedTransaction, preparedTransactionHash, status
- +
- - - + + +
- + +
+
+ id + string + + required + +
+ +
+
commandId string - + required - +
- +
- +
status string - + required - +
- +
- +
preparedTransaction string - + required - +
- +
- +
preparedTransactionHash string - + required - +
- +
- +
- - - - + + + +
+## Lifecycle Changes + +
+ +
+ 0.27.0 + params updated: `params`; result updated (required fields) +
+ +
+ ## Related Schemas @@ -241,82 +265,93 @@ title: "getTransaction"
- - + +
- +
- commandId + transactionId string - + required - +
- +
- +
- - + +
- - + +
- + +
+
+ id + string + + required + +
+ +
+
commandId string - + required - +
- +
- +
status string - + required - +
- +
- +
preparedTransaction string - + required - +
- +
- +
preparedTransactionHash string - + required - +
- +
- +
- - + +
@@ -326,12 +361,12 @@ title: "getTransaction"
- +
cURL - +
```bash cURL @@ -345,7 +380,7 @@ curl \ "method": "getTransaction", "params": { "params": { - "commandId": "" + "transactionId": "" } } } @@ -354,18 +389,19 @@ EOF
- +
Result - + application/json - +
```json Result { + "id": "", "commandId": "", "status": "", "preparedTransaction": "", @@ -375,7 +411,7 @@ EOF
- +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/getuser.mdx b/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/getuser.mdx index 60189ce5c..8d897cbe8 100644 --- a/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/getuser.mdx +++ b/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/getuser.mdx @@ -9,53 +9,53 @@ title: "getUser"
- +

User API

- - + +

getUser

- - - + + +
- + JSON-RPC - + Since 0.24.0 - +
- +
- + POST - + JSON-RPC getUser
@@ -63,32 +63,32 @@ title: "getUser"
- +
Protocol
JSON-RPC
- +
Transport
HTTP POST
- +
Method
getUser
- +
Parameters
0
- +
Result
object
- +
@@ -102,58 +102,58 @@ title: "getUser"

result

- +
- - - + + +
- +
Shape
object
- +
Required
isAdmin, userId
- +
- - - + + +
- +
userId string - + required - +
- +
- +
isAdmin string - + required - +
- +
- +
- - - - + + + +
@@ -168,36 +168,36 @@ title: "getUser"
- - + +
- +
userId string - + required - +
- +
- +
isAdmin string - + required - +
- +
- +
- - + +
@@ -207,12 +207,12 @@ title: "getUser"
- +
cURL - +
```bash cURL @@ -230,14 +230,14 @@ EOF
- +
Result - + application/json - +
```json Result @@ -249,7 +249,7 @@ EOF
- +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/iswalletsyncneeded.mdx b/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/iswalletsyncneeded.mdx index 352238386..b8583432b 100644 --- a/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/iswalletsyncneeded.mdx +++ b/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/iswalletsyncneeded.mdx @@ -9,53 +9,53 @@ title: "isWalletSyncNeeded"
- +

User API

- - + +

isWalletSyncNeeded

- - - + + +
- + JSON-RPC - + Since 0.24.0 - +
- +
- + POST - + JSON-RPC isWalletSyncNeeded
@@ -63,32 +63,32 @@ title: "isWalletSyncNeeded"
- +
Protocol
JSON-RPC
- +
Transport
HTTP POST
- +
Method
isWalletSyncNeeded
- +
Parameters
0
- +
Result
object
- +
@@ -102,47 +102,47 @@ title: "isWalletSyncNeeded"

result

- +
- - - + + +
- +
Shape
object
- +
Required
walletSyncNeeded
- +
- - - + + +
- +
walletSyncNeeded string - + required - +
- +
- +
- - - - + + + +
@@ -157,25 +157,25 @@ title: "isWalletSyncNeeded"
- - + +
- +
walletSyncNeeded string - + required - +
- +
- +
- - + +
@@ -185,12 +185,12 @@ title: "isWalletSyncNeeded"
- +
cURL - +
```bash cURL @@ -208,14 +208,14 @@ EOF
- +
Result - + application/json - +
```json Result @@ -226,7 +226,7 @@ EOF
- +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/listidps.mdx b/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/listidps.mdx index 2dea720d3..d2a3bec17 100644 --- a/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/listidps.mdx +++ b/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/listidps.mdx @@ -9,53 +9,53 @@ title: "listIdps"
- +

User API

- - + +

listIdps

- - - + + +
- + JSON-RPC - + Since 0.24.0 - +
- +
- + POST - + JSON-RPC listIdps
@@ -63,32 +63,32 @@ title: "listIdps"
- +
Protocol
JSON-RPC
- +
Transport
HTTP POST
- +
Method
listIdps
- +
Parameters
0
- +
Result
object
- +
@@ -102,47 +102,47 @@ title: "listIdps"

result

- +
- - - + + +
- +
Shape
object
- +
Required
idps
- +
- - - + + +
- +
idps array[object] - + required - +
- +
- +
- - - - + + + +
@@ -157,25 +157,25 @@ title: "listIdps"
- - + +
- +
idps array[object] - + required - +
- +
- +
- - + +
@@ -185,12 +185,12 @@ title: "listIdps"
- +
cURL - +
```bash cURL @@ -208,14 +208,14 @@ EOF
- +
Result - + application/json - +
```json Result @@ -232,7 +232,7 @@ EOF
- +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/listmessagestosign.mdx b/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/listmessagestosign.mdx new file mode 100644 index 000000000..b24eb5ef8 --- /dev/null +++ b/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/listmessagestosign.mdx @@ -0,0 +1,241 @@ +--- +title: "listMessagesToSign" +--- + +
+ +
+
+ + + + + +
+ +

User API

+ + +

listMessagesToSign

+ + + +
+ + JSON-RPC + + Since 1.4.0 + +
+ + +
+ +
+ + POST + + JSON-RPC listMessagesToSign +
+ +## Protocol Details + + +
+ +
+
Protocol
+
JSON-RPC
+
+ +
+
Transport
+
HTTP POST
+
+ +
+
Method
+
listMessagesToSign
+
+ +
+
Parameters
+
0
+
+ +
+
Result
+
object
+
+ +
+ + +## Inputs + + + +## Outputs + + +
+
+

result

+ +
+ + + +
+ +
+
Shape
+
object
+
+ +
+
Required
+
messages
+
+ +
+ + + + +
+ +
+
+ messages + array[object] + + required + +
+ +
+ +
+ + + + + +
+ + + + + + + +## Related Schemas + + + + +
+ + +
+ +
+
+ messages + array[object] + + required + +
+ +
+ +
+ + + +
+
+ +
+ + +
+ +
+ +
+
+
+ cURL + +
+ +```bash cURL +curl \ + \ + -H 'content-type: application/json' \ + --data @- <<'EOF' +{ + "jsonrpc": "2.0", + "id": 1, + "method": "listMessagesToSign" +} +EOF +``` + +
+
+ +
+
+
+ Result + + application/json + +
+ +```json Result +{ + "messages": [ + { + "id": "", + "status": "", + "partyId": "", + "publicKey": "", + "message": "", + "createdAt": "" + } + ] +} +``` + +
+
+ +
+ +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/listnetworks.mdx b/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/listnetworks.mdx index 11da24ba8..a2f672df3 100644 --- a/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/listnetworks.mdx +++ b/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/listnetworks.mdx @@ -9,53 +9,55 @@ title: "listNetworks"
- +

User API

- - + +

listNetworks

- - - + + +
- + JSON-RPC - + Since 0.24.0 - + + Changed 1.4.0 +
- +
- + POST - + JSON-RPC listNetworks
@@ -63,32 +65,32 @@ title: "listNetworks"
- +
Protocol
JSON-RPC
- +
Transport
HTTP POST
- +
Method
listNetworks
- +
Parameters
0
- +
Result
object
- +
@@ -102,53 +104,64 @@ title: "listNetworks"

result

- +
- - - + + +
- +
Shape
object
- +
Required
networks
- +
- - - + + +
- +
networks array[object] - + required - +
- +
- +
- - - - + + + +
+## Lifecycle Changes + +
+ +
+ 1.4.0 + description updated +
+ +
+ ## Related Schemas @@ -157,25 +170,25 @@ title: "listNetworks"
- - + +
- +
networks array[object] - + required - +
- +
- +
- - + +
@@ -185,12 +198,12 @@ title: "listNetworks"
- +
cURL - +
```bash cURL @@ -208,14 +221,14 @@ EOF
- +
Result - + application/json - +
```json Result @@ -226,13 +239,8 @@ EOF "name": "", "description": "", "identityProviderId": "", - "auth": { - "method": "", - "scope": "", - "clientId": "", - "audience": "" - }, - "ledgerApi": "" + "ledgerApi": "", + "authMethod": "" } ] } @@ -240,7 +248,7 @@ EOF
- +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/listsessions.mdx b/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/listsessions.mdx index 07b621ae7..0f7136051 100644 --- a/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/listsessions.mdx +++ b/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/listsessions.mdx @@ -9,53 +9,53 @@ title: "listSessions"
- +

User API

- - + +

listSessions

- - - + + +
- + JSON-RPC - + Since 0.24.0 - +
- +
- + POST - + JSON-RPC listSessions
@@ -63,32 +63,32 @@ title: "listSessions"
- +
Protocol
JSON-RPC
- +
Transport
HTTP POST
- +
Method
listSessions
- +
Parameters
0
- +
Result
object
- +
@@ -102,47 +102,47 @@ title: "listSessions"

result

- +
- - - + + +
- +
Shape
object
- +
Required
sessions
- +
- - - + + +
- +
sessions array[object] - + required - +
- +
- +
- - - - + + + +
@@ -157,25 +157,25 @@ title: "listSessions"
- - + +
- +
sessions array[object] - + required - +
- +
- +
- - + +
@@ -185,12 +185,12 @@ title: "listSessions"
- +
cURL - +
```bash cURL @@ -208,14 +208,14 @@ EOF
- +
Result - + application/json - +
```json Result @@ -248,7 +248,7 @@ EOF
- +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/listtransactions.mdx b/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/listtransactions.mdx index 5b3951f52..6ace3f075 100644 --- a/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/listtransactions.mdx +++ b/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/listtransactions.mdx @@ -9,53 +9,55 @@ title: "listTransactions"
- +

User API

- - + +

listTransactions

- - - + + +
- + JSON-RPC - + Since 0.24.0 - + + Changed 0.27.0 +
- +
- + POST - + JSON-RPC listTransactions
@@ -63,32 +65,32 @@ title: "listTransactions"
- +
Protocol
JSON-RPC
- +
Transport
HTTP POST
- +
Method
listTransactions
- +
Parameters
0
- +
Result
object
- +
@@ -102,53 +104,64 @@ title: "listTransactions"

result

- +
- - - + + +
- +
Shape
object
- +
Required
transactions
- +
- - - + + +
- +
transactions array[object] - + required - +
- +
- +
- - - - + + + +
+## Lifecycle Changes + +
+ +
+ 0.27.0 + details updated +
+ +
+ ## Related Schemas @@ -157,25 +170,25 @@ title: "listTransactions"
- - + +
- +
transactions array[object] - + required - +
- +
- +
- - + +
@@ -185,12 +198,12 @@ title: "listTransactions"
- +
cURL - +
```bash cURL @@ -208,20 +221,21 @@ EOF
- +
Result - + application/json - +
```json Result { "transactions": [ { + "id": "", "commandId": "", "status": "", "preparedTransaction": "", @@ -233,7 +247,7 @@ EOF
- +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/listwallets.mdx b/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/listwallets.mdx index 0670bd5e7..9bfdc1d15 100644 --- a/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/listwallets.mdx +++ b/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/listwallets.mdx @@ -9,53 +9,53 @@ title: "listWallets"
- +

User API

- - + +

listWallets

- - - + + +
- + JSON-RPC - + Since 0.24.0 - +
- +
- + POST - + JSON-RPC listWallets
@@ -63,32 +63,32 @@ title: "listWallets"
- +
Protocol
JSON-RPC
- +
Transport
HTTP POST
- +
Method
listWallets
- +
Parameters
1
- +
Result
array[object]
- +
@@ -98,40 +98,40 @@ title: "listWallets"

params

- +
- - - + + +
- +
Shape
object
- +
- - - + + +
- +
filter object - +
- +
- +
- - - - + + + +
@@ -141,42 +141,42 @@ title: "listWallets"

result

- +
- - - + + +
- +
Shape
array[object]
- +
- - - + + +
- +
items object - + required - +
- +
- +
- - - - + + + +
@@ -191,47 +191,47 @@ title: "listWallets"
- - + +
- +
filter object - +
- +
- +
- - + +
- - + +
- +
items object - + required - +
- +
- +
- - + +
@@ -241,12 +241,12 @@ title: "listWallets"
- +
cURL - +
```bash cURL @@ -276,14 +276,14 @@ EOF
- +
Result - + application/json - +
```json Result @@ -303,7 +303,7 @@ EOF
- +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/removeidp.mdx b/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/removeidp.mdx index 43f87d036..7b7228b3d 100644 --- a/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/removeidp.mdx +++ b/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/removeidp.mdx @@ -9,53 +9,53 @@ title: "removeIdp"
- +

User API

- - + +

removeIdp

- - - + + +
- + JSON-RPC - + Since 0.24.0 - +
- +
- + POST - + JSON-RPC removeIdp
@@ -63,32 +63,32 @@ title: "removeIdp"
- +
Protocol
JSON-RPC
- +
Transport
HTTP POST
- +
Method
removeIdp
- +
Parameters
1
- +
Result
null
- +
@@ -98,47 +98,47 @@ title: "removeIdp"

params

- +
- - - + + +
- +
Shape
object
- +
Required
identityProviderId
- +
- - - + + +
- +
identityProviderId string - + required - +
- +
- +
- - - - + + + +
@@ -148,32 +148,32 @@ title: "removeIdp"

result

- +
- - - + + +
- +
Shape
null
- +
Schema
Null
- +
- - - - - - - + + + + + + +
@@ -188,34 +188,34 @@ title: "removeIdp"
- - + +
- +
identityProviderId string - + required - +
- +
- +
- - + +
- - - - + + + +
@@ -225,12 +225,12 @@ title: "removeIdp"
- +
cURL - +
```bash cURL @@ -253,14 +253,14 @@ EOF
- +
Result - + application/json - +
```json Result @@ -269,7 +269,7 @@ EOF
- +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/removenetwork.mdx b/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/removenetwork.mdx index a9fbfc006..a6b355681 100644 --- a/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/removenetwork.mdx +++ b/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/removenetwork.mdx @@ -9,53 +9,53 @@ title: "removeNetwork"
- +

User API

- - + +

removeNetwork

- - - + + +
- + JSON-RPC - + Since 0.24.0 - +
- +
- + POST - + JSON-RPC removeNetwork
@@ -63,32 +63,32 @@ title: "removeNetwork"
- +
Protocol
JSON-RPC
- +
Transport
HTTP POST
- +
Method
removeNetwork
- +
Parameters
1
- +
Result
null
- +
@@ -98,47 +98,47 @@ title: "removeNetwork"

params

- +
- - - + + +
- +
Shape
object
- +
Required
networkName
- +
- - - + + +
- +
networkName string - + required - +
- +
- +
- - - - + + + +
@@ -148,32 +148,32 @@ title: "removeNetwork"

result

- +
- - - + + +
- +
Shape
null
- +
Schema
Null
- +
- - - - - - - + + + + + + +
@@ -188,34 +188,34 @@ title: "removeNetwork"
- - + +
- +
networkName string - + required - +
- +
- +
- - + +
- - - - + + + +
@@ -225,12 +225,12 @@ title: "removeNetwork"
- +
cURL - +
```bash cURL @@ -253,14 +253,14 @@ EOF
- +
Result - + application/json - +
```json Result @@ -269,7 +269,7 @@ EOF
- +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/removesession.mdx b/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/removesession.mdx index 16e531d61..cc589a3f6 100644 --- a/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/removesession.mdx +++ b/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/removesession.mdx @@ -9,53 +9,53 @@ title: "removeSession"
- +

User API

- - + +

removeSession

- - - + + +
- + JSON-RPC - + Since 0.24.0 - +
- +
- + POST - + JSON-RPC removeSession
@@ -63,32 +63,32 @@ title: "removeSession"
- +
Protocol
JSON-RPC
- +
Transport
HTTP POST
- +
Method
removeSession
- +
Parameters
0
- +
Result
null
- +
@@ -102,32 +102,32 @@ title: "removeSession"

result

- +
- - - + + +
- +
Shape
null
- +
Schema
Null
- +
- - - - - - - + + + + + + +
@@ -142,10 +142,10 @@ title: "removeSession"
- - - - + + + +
@@ -155,12 +155,12 @@ title: "removeSession"
- +
cURL - +
```bash cURL @@ -178,14 +178,14 @@ EOF
- +
Result - + application/json - +
```json Result @@ -194,7 +194,7 @@ EOF
- +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/removewallet.mdx b/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/removewallet.mdx index f1abab1f5..930ee7baa 100644 --- a/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/removewallet.mdx +++ b/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/removewallet.mdx @@ -9,53 +9,53 @@ title: "removeWallet"
- +

User API

- - + +

removeWallet

- - - + + +
- + JSON-RPC - + Since 0.24.0 - +
- +
- + POST - + JSON-RPC removeWallet
@@ -63,32 +63,32 @@ title: "removeWallet"
- +
Protocol
JSON-RPC
- +
Transport
HTTP POST
- +
Method
removeWallet
- +
Parameters
1
- +
Result
object
- +
@@ -98,47 +98,47 @@ title: "removeWallet"

params

- +
- - - + + +
- +
Shape
object
- +
Required
partyId
- +
- - - + + +
- +
partyId string - + required - +
- +
- +
- - - - + + + +
@@ -148,27 +148,27 @@ title: "removeWallet"

result

- +
- - - + + +
- +
Shape
object
- +
- - - - - - - + + + + + + +
@@ -183,34 +183,34 @@ title: "removeWallet"
- - + +
- +
partyId string - + required - +
- +
- +
- - + +
- - - - + + + +
@@ -220,12 +220,12 @@ title: "removeWallet"
- +
cURL - +
```bash cURL @@ -248,14 +248,14 @@ EOF
- +
Result - + application/json - +
```json Result @@ -264,7 +264,7 @@ EOF
- +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/selfsignedaccesstoken.mdx b/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/selfsignedaccesstoken.mdx new file mode 100644 index 000000000..842286d1d --- /dev/null +++ b/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/selfsignedaccesstoken.mdx @@ -0,0 +1,330 @@ +--- +title: "selfSignedAccessToken" +--- + +
+ +
+
+ + + + + +
+ +

User API

+ + +

selfSignedAccessToken

+ + + +
+ + JSON-RPC + + Since 1.4.0 + +
+ + +
+ +
+ + POST + + JSON-RPC selfSignedAccessToken +
+ +## Protocol Details + + +
+ +
+
Protocol
+
JSON-RPC
+
+ +
+
Transport
+
HTTP POST
+
+ +
+
Method
+
selfSignedAccessToken
+
+ +
+
Parameters
+
1
+
+ +
+
Result
+
object
+
+ +
+ + +## Inputs + + +
+
+

params

+ +
+ + + +
+ +
+
Shape
+
object
+
+ +
+
Required
+
clientId, networkId
+
+ +
+ + + + +
+ +
+
+ networkId + string + + required + +
+ +
+ +
+
+ clientId + string + + required + +
+ +
+ +
+ + + + + +
+ + +## Outputs + + +
+
+

result

+ +
+ + + +
+ +
+
Shape
+
object
+
+ +
+
Required
+
accessToken
+
+ +
+ + + + +
+ +
+
+ accessToken + string + + required + +
+ +
+ +
+ + + + + +
+ + + + + + + +## Related Schemas + + + + +
+ + +
+ +
+
+ networkId + string + + required + +
+ +
+ +
+
+ clientId + string + + required + +
+ +
+ +
+ + + +
+
+ + +
+ + +
+ +
+
+ accessToken + string + + required + +
+ +
+ +
+ + + +
+
+ +
+ + +
+ +
+ +
+
+
+ cURL + +
+ +```bash cURL +curl \ + \ + -H 'content-type: application/json' \ + --data @- <<'EOF' +{ + "jsonrpc": "2.0", + "id": 1, + "method": "selfSignedAccessToken", + "params": { + "params": { + "networkId": "", + "clientId": "" + } + } +} +EOF +``` + +
+
+ +
+
+
+ Result + + application/json + +
+ +```json Result +{ + "accessToken": "" +} +``` + +
+
+ +
+ +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/setprimarywallet.mdx b/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/setprimarywallet.mdx index ef9343643..5f67795c3 100644 --- a/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/setprimarywallet.mdx +++ b/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/setprimarywallet.mdx @@ -9,53 +9,53 @@ title: "setPrimaryWallet"
- +

User API

- - + +

setPrimaryWallet

- - - + + +
- + JSON-RPC - + Since 0.24.0 - +
- +
- + POST - + JSON-RPC setPrimaryWallet
@@ -63,32 +63,32 @@ title: "setPrimaryWallet"
- +
Protocol
JSON-RPC
- +
Transport
HTTP POST
- +
Method
setPrimaryWallet
- +
Parameters
1
- +
Result
null
- +
@@ -98,47 +98,47 @@ title: "setPrimaryWallet"

params

- +
- - - + + +
- +
Shape
object
- +
Required
partyId
- +
- - - + + +
- +
partyId string - + required - +
- +
- +
- - - - + + + +
@@ -148,32 +148,32 @@ title: "setPrimaryWallet"

result

- +
- - - + + +
- +
Shape
null
- +
Schema
Null
- +
- - - - - - - + + + + + + +
@@ -188,34 +188,34 @@ title: "setPrimaryWallet"
- - + +
- +
partyId string - + required - +
- +
- +
- - + +
- - - - + + + +
@@ -225,12 +225,12 @@ title: "setPrimaryWallet"
- +
cURL - +
```bash cURL @@ -253,14 +253,14 @@ EOF
- +
Result - + application/json - +
```json Result @@ -269,7 +269,7 @@ EOF
- +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/sign.mdx b/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/sign.mdx index 3e4a87ba0..318bec712 100644 --- a/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/sign.mdx +++ b/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/sign.mdx @@ -9,53 +9,55 @@ title: "sign"
- +

User API

- - + +

sign

- - - + + +
- + JSON-RPC - + Since 0.24.0 - + + Changed 0.27.0 +
- +
- + POST - + JSON-RPC sign
@@ -63,32 +65,32 @@ title: "sign"
- +
Protocol
JSON-RPC
- +
Transport
HTTP POST
- +
Method
sign
- +
Parameters
1
- +
Result
oneOf
- +
@@ -98,80 +100,58 @@ title: "sign"

params

- +
- - - + + +
- +
Shape
object
- +
Required
-
commandId, partyId, preparedTransaction, preparedTransactionHash
+
partyId, transactionId
- +
- - - + + +
- -
-
- preparedTransaction - string - - required - -
- -
- -
-
- preparedTransactionHash - string - - required - -
- -
- +
- commandId + transactionId string - + required - +
- +
- +
partyId string - + required - +
- +
- +
- - - - + + + +
@@ -181,73 +161,89 @@ title: "sign"

result

- +
- - - + + +
- +
Shape
oneOf
- +
- - - + + +
- +
status string - +
- +
- +
signature string - +
- +
- +
signedBy string - +
- +
- +
partyId string - +
- +
- +
- - - - + + + +
+## Lifecycle Changes + +
+ +
+ 0.26.0 + params updated: `params` +
+ +
+ 0.27.0 + params updated: `params` +
+ +
+ ## Related Schemas @@ -256,107 +252,85 @@ title: "sign"
- - + +
- -
-
- preparedTransaction - string - - required - -
- -
- -
-
- preparedTransactionHash - string - - required - -
- -
- +
- commandId + transactionId string - + required - +
- +
- +
partyId string - + required - +
- +
- +
- - + +
- - + +
- +
status string - +
- +
- +
signature string - +
- +
- +
signedBy string - +
- +
- +
partyId string - +
- +
- +
- - + +
@@ -366,12 +340,12 @@ title: "sign"
- +
cURL - +
```bash cURL @@ -385,9 +359,7 @@ curl \ "method": "sign", "params": { "params": { - "preparedTransaction": "", - "preparedTransactionHash": "", - "commandId": "", + "transactionId": "", "partyId": "" } } @@ -397,14 +369,14 @@ EOF
- +
Result - + application/json - +
```json Result @@ -418,7 +390,7 @@ EOF
- +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/signmessage.mdx b/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/signmessage.mdx new file mode 100644 index 000000000..893c1873e --- /dev/null +++ b/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/signmessage.mdx @@ -0,0 +1,330 @@ +--- +title: "signMessage" +--- + +
+ +
+
+ + + + + +
+ +

User API

+ + +

signMessage

+ + + +
+ + JSON-RPC + + Since 1.4.0 + +
+ + +
+ +
+ + POST + + JSON-RPC signMessage +
+ +## Protocol Details + + +
+ +
+
Protocol
+
JSON-RPC
+
+ +
+
Transport
+
HTTP POST
+
+ +
+
Method
+
signMessage
+
+ +
+
Parameters
+
1
+
+ +
+
Result
+
object
+
+ +
+ + +## Inputs + + +
+
+

params

+ +
+ + + +
+ +
+
Shape
+
object
+
+ +
+
Required
+
messageId
+
+ +
+ + + + +
+ +
+
+ messageId + string + + required + +
+ +
+ +
+ + + + + +
+ + +## Outputs + + +
+
+

result

+ +
+ + + +
+ +
+
Shape
+
object
+
+ +
+
Required
+
publicKey, signature
+
+ +
+ + + + +
+ +
+
+ signature + string + + required + +
+ +
+ +
+
+ publicKey + string + + required + +
+ +
+ +
+ + + + + +
+ + + + + + + +## Related Schemas + + + + +
+ + +
+ +
+
+ messageId + string + + required + +
+ +
+ +
+ + + +
+
+ + +
+ + +
+ +
+
+ signature + string + + required + +
+ +
+ +
+
+ publicKey + string + + required + +
+ +
+ +
+ + + +
+
+ +
+ + +
+ +
+ +
+
+
+ cURL + +
+ +```bash cURL +curl \ + \ + -H 'content-type: application/json' \ + --data @- <<'EOF' +{ + "jsonrpc": "2.0", + "id": 1, + "method": "signMessage", + "params": { + "params": { + "messageId": "" + } + } +} +EOF +``` + +
+
+ +
+
+
+ Result + + application/json + +
+ +```json Result +{ + "signature": "", + "publicKey": "" +} +``` + +
+
+ +
+ +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/syncwallets.mdx b/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/syncwallets.mdx index 2c52cd33e..72ef69f2d 100644 --- a/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/syncwallets.mdx +++ b/docs-main/reference/wallet-gateway-json-rpc/operations/user-api/syncwallets.mdx @@ -9,53 +9,53 @@ title: "syncWallets"
- +

User API

- - + +

syncWallets

- - - + + +
- + JSON-RPC - + Since 0.24.0 - +
- +
- + POST - + JSON-RPC syncWallets
@@ -63,32 +63,32 @@ title: "syncWallets"
- +
Protocol
JSON-RPC
- +
Transport
HTTP POST
- +
Method
syncWallets
- +
Parameters
0
- +
Result
object
- +
@@ -102,69 +102,69 @@ title: "syncWallets"

result

- +
- - - + + +
- +
Shape
object
- +
Required
added, disabled, updated
- +
- - - + + +
- +
added array[object] - + required - +
- +
- +
updated array[object] - + required - +
- +
- +
disabled array[object] - + required - +
- +
- +
- - - - + + + +
@@ -179,47 +179,47 @@ title: "syncWallets"
- - + +
- +
added array[object] - + required - +
- +
- +
updated array[object] - + required - +
- +
- +
disabled array[object] - + required - +
- +
- +
- - + +
@@ -229,12 +229,12 @@ title: "syncWallets"
- +
cURL - +
```bash cURL @@ -252,14 +252,14 @@ EOF
- +
Result - + application/json - +
```json Result @@ -305,7 +305,7 @@ EOF
- +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/specs/dapp-api.mdx b/docs-main/reference/wallet-gateway-json-rpc/specs/dapp-api.mdx index 72ca45f77..8447b06c1 100644 --- a/docs-main/reference/wallet-gateway-json-rpc/specs/dapp-api.mdx +++ b/docs-main/reference/wallet-gateway-json-rpc/specs/dapp-api.mdx @@ -6,47 +6,49 @@ description: "An OpenRPC specification for the dapp to interact with a Wallet Pr

Back to overview

- +

OpenRPC Spec

- - + +

Sync dApp API

- - + +

An OpenRPC specification for the dapp to interact with a Wallet Provider.

- - + +
- + JSON-RPC - + Since 0.24.0 - + + Changed 1.4.0 +
- +
- +
Latest source path
api-specs/openrpc-dapp-api.json
- +
Publish version
-
0.25.0
+
1.4.0
- +
OpenRPC version
1.2.6
- +
Spec info.version
0.5.0
- +
@@ -60,445 +62,521 @@ Method pages are the primary reference surface. This spec page stays focused on
- - + + - +

accountsChanged

- +
- + JSON-RPC - + Since 0.24.0 - +
- - + +
- +
Parameters
0
- +
Result
array[object]
- +
- +
- - - + + + - +

connect

- +
- + JSON-RPC - + Since 0.24.0 - +
- +

Ensures ledger connectivity and returns the connected network information along with the session information.

- - + +
- +
Parameters
0
- +
Result
object
- +
- +
- - - + + + - +

disconnect

- +
- + JSON-RPC - + Since 0.24.0 - +
- +

Invoke a disconnect of the wallet provider session.

- - + +
- +
Parameters
0
- +
Result
null
- +
- +
- - - + + + - +

getActiveNetwork

- +
- + JSON-RPC - + Since 0.24.0 - +
- +

Returns the active network.

- - + +
- +
Parameters
0
- +
Result
object
- +
- +
- - - + + + - +

getPrimaryAccount

- +
- + JSON-RPC - + Since 0.24.0 - +
- +

Returns the primary account.

- - + + +
+ +
+
Parameters
+
0
+
+ +
+
Result
+
object
+
+ +
+ + +
+ + + + + +
+

isConnected

+ +
+ + JSON-RPC + + Since 0.26.0 + +
+ +
+ +

Returns the connection status and the connected network information.

+ +
- +
Parameters
0
- +
Result
object
- +
- +
- - - + + + - +

ledgerApi

- +
- + JSON-RPC - + Since 0.24.0 - +
- +

Proxy for the JSON-API endpoints. Injects authorization headers automatically.

- - + +
- +
Parameters
1
- +
Result
object
- +
- +
- - - + + + - +

listAccounts

- +
- + JSON-RPC - + Since 0.24.0 - +
- +

Lists the addresses (wallets) with their properties; including which network they are associated to and with signing provider is used.

- - + +
- +
Parameters
0
- +
Result
array[object]
- + +
+ + +
+ + + + + +
+

messageSignature

+ +
+ + JSON-RPC + + Since 1.4.0 + +
+ +
+ + +
+ +
+
Parameters
+
0
+
+ +
+
Result
+
oneOf
+
+
- +
- - - + + + - +

prepareExecute

- +
- + JSON-RPC - + Since 0.24.0 - + + Changed 1.4.0 +
- +

Prepares a transaction for subsequent signing & execution.

- - + +
- +
Parameters
1
- +
Result
null
- +
- +
- - - + + + - +

prepareExecuteAndWait

- +
- + JSON-RPC - + Since 0.24.0 - + + Changed 1.4.0 +
- +

Like prepareExecute, but waits for the transaction to be executed on the ledger.

- - + +
- +
Parameters
1
- +
Result
object
- +
- +
- - - + + + - +

signMessage

- +
- + JSON-RPC - + Since 0.24.0 - +
- +

Signs a message.

- - + +
- +
Parameters
1
- +
Result
object
- +
- +
- - - + + + - +

status

- +
- + JSON-RPC - + Since 0.24.0 - +
- +

Returns the current status of the wallet provider session.

- - + +
- +
Parameters
0
- +
Result
object
- +
- +
- - - + + + - +

txChanged

- +
- + JSON-RPC - + Since 0.24.0 - +
- - + +
- +
Parameters
0
- +
Result
oneOf
- +
- +
- - + +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/specs/dapp-remote-api.mdx b/docs-main/reference/wallet-gateway-json-rpc/specs/dapp-remote-api.mdx index 239816fdd..0bbd7885f 100644 --- a/docs-main/reference/wallet-gateway-json-rpc/specs/dapp-remote-api.mdx +++ b/docs-main/reference/wallet-gateway-json-rpc/specs/dapp-remote-api.mdx @@ -6,47 +6,49 @@ description: "An OpenRPC specification for remotely hosted Wallet Providers. Due

Back to overview

- +

OpenRPC Spec

- - + +

Async dApp API

- - + +

An OpenRPC specification for remotely hosted Wallet Providers. Due to the remote nature, an implementing provider must bridge certain functionality on the client-side to satisfy the general dApp API spec.

- - + +
- + JSON-RPC - + Since 0.24.0 - + + Changed 1.4.0 +
- +
- +
Latest source path
api-specs/openrpc-dapp-remote-api.json
- +
Publish version
-
0.25.0
+
1.4.0
- +
OpenRPC version
1.2.6
- +
Spec info.version
0.1.0
- +
@@ -60,478 +62,554 @@ Method pages are the primary reference surface. This spec page stays focused on
- - + + - +

accountsChanged

- +
- + JSON-RPC - + Since 0.24.0 - +
- - + +
- +
Parameters
0
- +
Result
array[object]
- +
- +
- - - + + + - +

connect

- +
- + JSON-RPC - + Since 0.24.0 - +
- +

Ensures ledger connectivity and returns the connected network information.

- - + +
- +
Parameters
0
- +
Result
object
- +
- +
- - - + + + - +

connected

- +
- + JSON-RPC - + Since 0.24.0 - +
- +

Informs when the user connects to a network.

- - + +
- +
Parameters
0
- +
Result
object
- +
- +
- - - + + + - +

disconnect

- +
- + JSON-RPC - + Since 0.24.0 - +
- +

Invoke a disconnect of the wallet gateway session.

- - + +
- +
Parameters
0
- +
Result
null
- +
- +
- - - + + + - +

getActiveNetwork

- +
- + JSON-RPC - + Since 0.24.0 - +
- +

Returns the active network.

- - + +
- +
Parameters
0
- +
Result
object
- +
- +
- - - + + + - +

getPrimaryAccount

- +
- + JSON-RPC - + Since 0.24.0 - +
- +

Returns the primary account.

- - + +
- +
Parameters
0
- +
Result
object
- +
- + +
+ + + + + +
+

isConnected

+ +
+ + JSON-RPC + + Since 0.26.0 + +
+ +
+ +

Returns the connection status and the connected network information.

+ + +
+ +
+
Parameters
+
0
+
+ +
+
Result
+
object
+
+ +
+ +
- - - + + + - +

ledgerApi

- +
- + JSON-RPC - + Since 0.24.0 - +
- +

Proxy for the JSON-API endpoints. Injects authorization headers automatically.

- - + +
- +
Parameters
1
- +
Result
object
- +
- +
- - - + + + - +

listAccounts

- +
- + JSON-RPC - + Since 0.24.0 - +
- - + +
- +
Parameters
0
- +
Result
array[object]
- +
- +
- - - + + + + + +
+

messageSignature

+ +
+ + JSON-RPC + + Since 1.4.0 + +
+ +
+ + +
+ +
+
Parameters
+
0
+
+ +
+
Result
+
oneOf
+
+ +
+ + +
+ + + - +

onStatusChanged

- +
- + JSON-RPC - + Since 0.24.0 - +
- - + +
- +
Parameters
0
- +
Result
object
- +
- +
- - - + + + - +

prepareExecute

- +
- + JSON-RPC - + Since 0.24.0 - + + Changed 1.4.0 +
- +

Prepares, signs, and executes a transaction.

- - + +
- +
Parameters
1
- +
Result
object
- +
- +
- - - + + + - +

signMessage

- +
- + JSON-RPC - + Since 0.24.0 - + + Changed 1.4.0 +
- -

Signs a message.

- - + +

Requests a message signature. The wallet will prompt the user for confirmation.

+ +
- +
Parameters
1
- +
Result
object
- +
- +
- - - + + + - +

status

- +
- + JSON-RPC - + Since 0.24.0 - +
- +

Returns the current status of the wallet provider session.

- - + +
- +
Parameters
0
- +
Result
object
- +
- +
- - - + + + - +

txChanged

- +
- + JSON-RPC - + Since 0.24.0 - +
- - + +
- +
Parameters
0
- +
Result
oneOf
- +
- +
- - + +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/specs/signing-api.mdx b/docs-main/reference/wallet-gateway-json-rpc/specs/signing-api.mdx index 693757121..09dd08a2e 100644 --- a/docs-main/reference/wallet-gateway-json-rpc/specs/signing-api.mdx +++ b/docs-main/reference/wallet-gateway-json-rpc/specs/signing-api.mdx @@ -6,47 +6,47 @@ description: "An OpenRPC specification for the Signing API which allows the Wall

Back to overview

- +

OpenRPC Spec

- - + +

Signing API

- - + +

An OpenRPC specification for the Signing API which allows the Wallet Gateway to interact with a Wallet Providers.

- - + +
- + JSON-RPC - + Since 0.24.0 - +
- +
- +
Latest source path
api-specs/openrpc-signing-api.json
- +
Publish version
-
0.25.0
+
1.4.0
- +
OpenRPC version
1.2.6
- +
Spec info.version
0.1.0
- +
@@ -60,299 +60,336 @@ Method pages are the primary reference surface. This spec page stays focused on
- - + + - +

createKey

- +
- + JSON-RPC - + Since 0.24.0 - +
- +

Create a new key at the Wallet Provider.

- - + +
- +
Parameters
1
- +
Result
oneOf
- +
- +
- - - + + + - +

getConfiguration

- +
- + JSON-RPC - + Since 0.24.0 - +
- - + +
- +
Parameters
0
- +
Result
object
- +
- +
- - - + + + - +

getKeys

- +
- + JSON-RPC - + Since 0.24.0 - +
- +

Get a list of public keys availabile for signing.

- - + +
- +
Parameters
0
- +
Result
oneOf
- +
- +
- - - + + + - +

getTransaction

- +
- + JSON-RPC - + Since 0.24.0 - +
- +

Get the status of a single transaction by its ID.

- - + +
- +
Parameters
1
- +
Result
oneOf
- +
- +
- - - + + + - +

getTransactions

- +
- + JSON-RPC - + Since 0.24.0 - +
- +

Get the status of multiple transactions, filtering by txIds or publicKeys. Either publicKeys or txIds must be provided.

- - + +
- +
Parameters
1
- +
Result
oneOf
- +
- +
- - - + + + - +

setConfiguration

- +
- + JSON-RPC - + Since 0.24.0 - +
- +

Set configuration parameters for the Wallet Provider. The paramaters will change depending on the Wallet Provider implementation

- - + +
- +
Parameters
1
- +
Result
object
- + +
+ + +
+ + + + + +
+

signMessage

+ +
+ + JSON-RPC + + Since 1.4.0 + +
+ +
+ +

Signs an arbitrary UTF-8 message with the wallet's private key (Ed25519). The message bytes are signed as-is; callers are expected to embed any application-level domai...

+ + +
+ +
+
Parameters
+
1
+
+ +
+
Result
+
oneOf
+
+
- +
- - - + + + - +

signTransaction

- +
- + JSON-RPC - + Since 0.24.0 - +
- +

Uses the Wallet Provider to sign a transaction. This will likely be an asynchronous operation.

- - + +
- +
Parameters
1
- +
Result
oneOf
- +
- +
- - - + + + - +

subscribeTransactions

- +
- + JSON-RPC - + Since 0.24.0 - +
- +

Subscribe to updates for specific transactions. The server will emit updates when the status of the specified transactions have changed. On initial subscription, the s...

- - + +
- +
Parameters
1
- +
Result
object
- +
- +
- - + +
diff --git a/docs-main/reference/wallet-gateway-json-rpc/specs/user-api.mdx b/docs-main/reference/wallet-gateway-json-rpc/specs/user-api.mdx index a724a05bb..0fea02b6a 100644 --- a/docs-main/reference/wallet-gateway-json-rpc/specs/user-api.mdx +++ b/docs-main/reference/wallet-gateway-json-rpc/specs/user-api.mdx @@ -6,47 +6,49 @@ description: "An OpenRPC specification for the user to interact with the Wallet

Back to overview

- +

OpenRPC Spec

- - + +

User API

- - + +

An OpenRPC specification for the user to interact with the Wallet Gateway.

- - + +
- + JSON-RPC - + Since 0.24.0 - + + Changed 1.4.0 +
- +
- +
Latest source path
api-specs/openrpc-user-api.json
- +
Publish version
-
0.25.0
+
1.4.0
- +
OpenRPC version
1.2.6
- +
Spec info.version
0.1.0
- +
@@ -60,809 +62,1043 @@ Method pages are the primary reference surface. This spec page stays focused on
- - + + - +

addIdp

- +
- + JSON-RPC - + Since 0.24.0 - +
- +

Adds a new identity provider.

- - + +
- +
Parameters
1
- +
Result
null
- +
- +
- - - + + + - +

addNetwork

- +
- + JSON-RPC - + Since 0.24.0 - +
- +

Adds a new network configuration (similar to EIP-3085).

- - + +
- +
Parameters
1
- +
Result
null
- +
- +
- - - + + + - +

addSession

- +
- + JSON-RPC - + Since 0.24.0 - +
- +

Adds a network session.

- - + +
- +
Parameters
1
- +
Result
object
- +
- +
- - - + + + - +

allocatePartyForWallet

- +
- + JSON-RPC - + Since 0.24.0 - +
- +

Allocates a party for an already initialized wallet if external signing is complete.

- - + +
- +
Parameters
1
- +
Result
object
- +
- +
- - - + + + - +

createWallet

- +
- + JSON-RPC - + Since 0.24.0 - +
- +

Creates a new wallet and party with the given hint.

- - + +
- +
Parameters
1
- +
Result
object
- +
- +
- - - - - + + + + +
-

deleteTransaction

- +

deleteMessageToSign

+
- + JSON-RPC - - Since 0.24.0 - + + Since 1.4.0 +
- -

Deletes a pending transaction. Only transactions with status 'pending' can be deleted.

- - + +

Rejects a pending message signing request.

+ +
- +
Parameters
1
- +
Result
null
- +
- +
- - - - - + + + + +
-

execute

- +

deleteTransaction

+
- + JSON-RPC - + Since 0.24.0 - + + Changed 0.27.0 +
- -

Executes a signed transaction.

- - + +

Deletes a pending transaction. Only transactions with status 'pending' can be deleted.

+ +
- +
Parameters
1
- +
Result
-
object
+
null
- +
- +
- - - - - + + + + +
-

getTransaction

- +

execute

+
- + JSON-RPC - + Since 0.24.0 - + + Changed 0.27.0 +
- - + +

Executes a signed transaction.

+ +
- +
Parameters
1
- +
Result
object
- +
- +
- - - - - + + + + +
-

getUser

- +

getMessageToSign

+
- + JSON-RPC - - Since 0.24.0 - + + Since 1.4.0 +
- -

Returns information about the current user, including whether they are an admin.

- - + +

Gets a pending message signing request.

+ +
- +
Parameters
-
0
+
1
- +
Result
object
- +
- +
- - - - - + + + + +
-

isWalletSyncNeeded

- +

getNetwork

+
- + JSON-RPC - - Since 0.24.0 - + + Since 1.4.0 +
- -

Checks if wallet sync is needed (disabled wallets or new parties on ledger).

- - + +

Returns full network configuration including auth details. Admin only.

+ +
- +
Parameters
-
0
+
1
- +
Result
object
- +
- +
- - - - - + + + + +
-

listIdps

- +

getTransaction

+
- + JSON-RPC - + Since 0.24.0 - + + Changed 0.27.0 +
- - + +
- +
Parameters
-
0
+
1
- +
Result
object
- +
- +
- - - - - + + + + +
-

listNetworks

- +

getUser

+
- + JSON-RPC - + Since 0.24.0 - +
- - + +

Returns information about the current user, including whether they are an admin.

+ +
- +
Parameters
0
- +
Result
object
- +
- +
- - - - - + + + + +
-

listSessions

- +

isWalletSyncNeeded

+
- + JSON-RPC - + Since 0.24.0 - +
- - + +

Checks if wallet sync is needed (disabled wallets or new parties on ledger).

+ +
- +
Parameters
0
- +
Result
object
- + +
+ + +
+ + + + + +
+

listIdps

+ +
+ + JSON-RPC + + Since 0.24.0 + +
+ +
+ + +
+ +
+
Parameters
+
0
+
+ +
+
Result
+
object
+
+
- +
- - - + + + + + +
+

listMessagesToSign

+ +
+ + JSON-RPC + + Since 1.4.0 + +
+ +
+ + +
+ +
+
Parameters
+
0
+
+ +
+
Result
+
object
+
+ +
+ + +
+ + + + + +
+

listNetworks

+ +
+ + JSON-RPC + + Since 0.24.0 + + Changed 1.4.0 + +
+ +
+ +

Lists configured networks without sensitive authentication details.

+ + +
+ +
+
Parameters
+
0
+
+ +
+
Result
+
object
+
+ +
+ + +
+ + + + + +
+

listSessions

+ +
+ + JSON-RPC + + Since 0.24.0 + +
+ +
+ + +
+ +
+
Parameters
+
0
+
+ +
+
Result
+
object
+
+ +
+ + +
+ + + - +

listTransactions

- +
- + JSON-RPC - + Since 0.24.0 - + + Changed 0.27.0 +
- - + +
- +
Parameters
0
- +
Result
object
- +
- +
- - - + + + - +

listWallets

- +
- + JSON-RPC - + Since 0.24.0 - +
- +

Lists wallets.

- - + +
- +
Parameters
1
- +
Result
array[object]
- +
- +
- - - + + + - +

removeIdp

- +
- + JSON-RPC - + Since 0.24.0 - +
- +

Removes an identity provider. Fails if an existing network is using the identity provider.

- - + +
- +
Parameters
1
- +
Result
null
- +
- +
- - - + + + - +

removeNetwork

- +
- + JSON-RPC - + Since 0.24.0 - +
- +

Removes a new network configuration (similar to EIP-3085).

- - + +
- +
Parameters
1
- +
Result
null
- +
- +
- - - + + + - +

removeSession

- +
- + JSON-RPC - + Since 0.24.0 - +
- +

Removes the current network session.

- - + +
- +
Parameters
0
- +
Result
null
- +
- +
- - - + + + - +

removeWallet

- +
- + JSON-RPC - + Since 0.24.0 - +
- +

Removes a party with the given hint.

- - + + +
+ +
+
Parameters
+
1
+
+ +
+
Result
+
object
+
+ +
+ + +
+ + + + + +
+

selfSignedAccessToken

+ +
+ + JSON-RPC + + Since 1.4.0 + +
+ +
+ +

Mints a self-signed access token using server-side network credentials. Used for login on self-signed networks.

+ +
- +
Parameters
1
- +
Result
object
- +
- +
- - - + + + - +

setPrimaryWallet

- +
- + JSON-RPC - + Since 0.24.0 - +
- +

Sets the specified wallet as the primary wallet for dApp usage.

- - + +
- +
Parameters
1
- +
Result
null
- +
- +
- - - + + + - +

sign

- +
- + JSON-RPC - + Since 0.24.0 - + + Changed 0.27.0 +
- +

Signs the provided data with the private key of the specified or active party.

- - + +
- +
Parameters
1
- +
Result
oneOf
- + +
+ + +
+ + + + + +
+

signMessage

+ +
+ + JSON-RPC + + Since 1.4.0 + +
+ +
+ +

Signs an arbitrary UTF-8 message with the wallet's private key (Ed25519). The message bytes are signed as-is; callers are expected to embed any application-level domai...

+ + +
+ +
+
Parameters
+
1
+
+ +
+
Result
+
object
+
+
- +
- - - + + + - +

syncWallets

- +
- + JSON-RPC - + Since 0.24.0 - +
- +

Synchronizes wallets with the connected network.

- - + +
- +
Parameters
0
- +
Result
object
- +
- +
- - + +
diff --git a/scripts/docs_env.py b/scripts/docs_env.py index e844cf4cd..e445020a8 100644 --- a/scripts/docs_env.py +++ b/scripts/docs_env.py @@ -1,6 +1,7 @@ from __future__ import annotations import os +import shutil import subprocess from pathlib import Path from typing import Sequence @@ -9,7 +10,20 @@ DIRENV_ENV_MARKER = "DIGITAL_ASSET_DOCS_DIRENV" +def should_run_directly() -> bool: + return ( + os.environ.get(DIRENV_ENV_MARKER) == "1" + or bool(os.environ.get("IN_NIX_SHELL")) + or shutil.which("direnv") is None + ) + + def repo_direnv_command(repo_root: Path, *args: str) -> list[str]: + if should_run_directly(): + if args and args[0] == "x2mdx": + return ["python3", "-m", "x2mdx.cli", *args[1:]] + return list(args) + if args and args[0] == "x2mdx": return [ "direnv", @@ -25,7 +39,7 @@ def repo_direnv_command(repo_root: Path, *args: str) -> list[str]: def ensure_repo_direnv(*, repo_root: Path, script_path: Path, argv: Sequence[str]) -> None: - if os.environ.get(DIRENV_ENV_MARKER) == "1": + if should_run_directly(): return env = os.environ.copy() diff --git a/scripts/generate_wallet_gateway_openrpc_reference.py b/scripts/generate_wallet_gateway_openrpc_reference.py index b2f26d6f4..4a28b7ef6 100644 --- a/scripts/generate_wallet_gateway_openrpc_reference.py +++ b/scripts/generate_wallet_gateway_openrpc_reference.py @@ -237,6 +237,14 @@ def write_details_pages(*, output_dir: Path, spec_entries: list[dict[str, Any]]) ) +def normalize_generated_mdx(output_dir: Path) -> None: + for path in sorted(output_dir.rglob("*.mdx")): + original = path.read_text(encoding="utf-8") + normalized = "\n".join(line.rstrip() for line in original.splitlines()) + "\n" + if normalized != original: + path.write_text(normalized, encoding="utf-8") + + def prune_nav_items(items: list[Any], *, page_refs: set[str], group_labels: set[str]) -> list[Any]: pruned: list[Any] = [] for item in items: @@ -269,14 +277,21 @@ def update_docs_navigation( if not isinstance(navigation, dict): raise ValueError(f"docs.json navigation must be an object: {docs_json_path}") dropdowns = navigation.get("dropdowns") - if not isinstance(dropdowns, list): - raise ValueError(f"docs.json navigation.dropdowns must be a list: {docs_json_path}") - dropdown = next((item for item in dropdowns if isinstance(item, dict) and item.get("dropdown") == dropdown_label), None) - if dropdown is None: - raise ValueError(f"Dropdown not found in docs.json: {dropdown_label}") - pages = dropdown.get("pages") + if isinstance(dropdowns, list): + nav_root = next((item for item in dropdowns if isinstance(item, dict) and item.get("dropdown") == dropdown_label), None) + if nav_root is None: + raise ValueError(f"Dropdown not found in docs.json: {dropdown_label}") + else: + products = navigation.get("products") + if not isinstance(products, list): + raise ValueError(f"docs.json navigation must define dropdowns or products: {docs_json_path}") + nav_root = next((item for item in products if isinstance(item, dict) and item.get("product") == dropdown_label), None) + if nav_root is None: + raise ValueError(f"Product not found in docs.json: {dropdown_label}") + + pages = nav_root.get("pages") if not isinstance(pages, list): - raise ValueError(f"Dropdown does not expose a pages list: {dropdown_label}") + raise ValueError(f"Navigation root does not expose a pages list: {dropdown_label}") refs = {overview_page_ref(output_dir, docs_json_path), docs_json_page_ref(output_dir / "operations" / "details.mdx", docs_json_path)} refs.update(spec_page_ref(output_dir, docs_json_path, spec["spec_id"]) for spec in spec_entries) @@ -310,7 +325,7 @@ def update_docs_navigation( break for offset, wallet_group in enumerate(wallet_groups): pruned_pages.insert(min(insert_at + offset, len(pruned_pages)), wallet_group) - dropdown["pages"] = pruned_pages + nav_root["pages"] = pruned_pages docs_json_path.write_text(json.dumps(docs, indent=2) + "\n", encoding="utf-8") print(f"Updated docs navigation: {docs_json_path}") @@ -453,6 +468,7 @@ def main() -> int: output_dir=Path(args.output_dir).resolve(), spec_entries=spec_entries, ) + normalize_generated_mdx(Path(args.output_dir).resolve()) update_docs_navigation( docs_json_path=Path(args.docs_json).resolve(), dropdown_label=args.nav_dropdown, diff --git a/scripts/update_generated_reference_sources.py b/scripts/update_generated_reference_sources.py index 5dc458d03..3bbe1cf12 100644 --- a/scripts/update_generated_reference_sources.py +++ b/scripts/update_generated_reference_sources.py @@ -10,12 +10,19 @@ from typing import Any import generate_splice_mintlify_openapi as splice_openapi +import generate_wallet_gateway_openrpc_reference as wallet_gateway_openrpc REPO_ROOT = Path(__file__).resolve().parents[1] DEFAULT_SPLICE_OPENAPI_SOURCE_CONFIG = ( REPO_ROOT / "config" / "mintlify-openapi" / "splice-openapi" / "source-artifacts.json" ) +DEFAULT_WALLET_GATEWAY_OPENRPC_SOURCE_CONFIG = ( + REPO_ROOT / "config" / "x2mdx" / "wallet-gateway-openrpc" / "source-artifacts.json" +) +SOURCE_SPLICE_OPENAPI = "splice-openapi" +SOURCE_WALLET_GATEWAY_OPENRPC = "wallet-gateway-openrpc" +ALL_SOURCES = (SOURCE_SPLICE_OPENAPI, SOURCE_WALLET_GATEWAY_OPENRPC) @dataclass(frozen=True) @@ -72,6 +79,55 @@ def update_splice_openapi_source( return update +def latest_wallet_gateway_openrpc_version(source_config: dict[str, Any]) -> str: + release_repo = source_config.get("release_repo") + tag_prefix = source_config.get("tag_prefix") + min_version = source_config.get("min_version") or "0.0.0" + if not isinstance(release_repo, str) or not release_repo: + raise ValueError("Wallet Gateway OpenRPC source config must define release_repo") + if not isinstance(tag_prefix, str) or not tag_prefix: + raise ValueError("Wallet Gateway OpenRPC source config must define tag_prefix") + if not isinstance(min_version, str): + raise ValueError("Wallet Gateway OpenRPC min_version must be a string") + + versions = wallet_gateway_openrpc.stable_release_versions( + release_repo=release_repo, + tag_prefix=tag_prefix, + min_version=min_version, + max_version=None, + include_versions=None, + ) + if not versions: + raise ValueError("No Wallet Gateway OpenRPC releases selected") + return versions[-1] + + +def update_wallet_gateway_openrpc_source( + *, + source_config_path: Path, + dry_run: bool, +) -> SourceUpdate | None: + source_config = load_json(source_config_path) + latest_version = latest_wallet_gateway_openrpc_version(source_config) + configured_version = source_config.get("publish_version") + if not isinstance(configured_version, str) or not configured_version: + raise ValueError(f"{source_config_path} must define non-empty publish_version") + if configured_version == latest_version: + return None + + update = SourceUpdate( + source="Wallet Gateway OpenRPC", + path=source_config_path, + field="publish_version", + previous=configured_version, + current=latest_version, + ) + if not dry_run: + source_config["publish_version"] = latest_version + write_json(source_config_path, source_config) + return update + + def parse_args() -> argparse.Namespace: parser = argparse.ArgumentParser( description="Update committed generated-reference source pins to their latest source versions." @@ -82,6 +138,25 @@ def parse_args() -> argparse.Namespace: default=DEFAULT_SPLICE_OPENAPI_SOURCE_CONFIG, help=f"Splice OpenAPI source-artifacts config. Default: {DEFAULT_SPLICE_OPENAPI_SOURCE_CONFIG}", ) + parser.add_argument( + "--wallet-gateway-openrpc-source-config", + type=Path, + default=DEFAULT_WALLET_GATEWAY_OPENRPC_SOURCE_CONFIG, + help=( + "Wallet Gateway OpenRPC source-artifacts config. " + f"Default: {DEFAULT_WALLET_GATEWAY_OPENRPC_SOURCE_CONFIG}" + ), + ) + parser.add_argument( + "--source", + action="append", + choices=ALL_SOURCES, + dest="sources", + help=( + "Limit updates to one source. Repeat to update multiple sources. " + "By default, all generated-reference sources are checked." + ), + ) parser.add_argument( "--dry-run", action="store_true", @@ -95,18 +170,28 @@ def parse_args() -> argparse.Namespace: return parser.parse_args() +def requested_sources(args: argparse.Namespace) -> tuple[str, ...]: + return tuple(dict.fromkeys(args.sources or ALL_SOURCES)) + + def main() -> int: args = parse_args() - updates = [ - update - for update in [ - update_splice_openapi_source( - source_config_path=args.splice_openapi_source_config.resolve(), - dry_run=args.dry_run or args.check, - ) - ] - if update is not None - ] + sources = requested_sources(args) + updates: list[SourceUpdate] = [] + if SOURCE_SPLICE_OPENAPI in sources: + update = update_splice_openapi_source( + source_config_path=args.splice_openapi_source_config.resolve(), + dry_run=args.dry_run or args.check, + ) + if update is not None: + updates.append(update) + if SOURCE_WALLET_GATEWAY_OPENRPC in sources: + update = update_wallet_gateway_openrpc_source( + source_config_path=args.wallet_gateway_openrpc_source_config.resolve(), + dry_run=args.dry_run or args.check, + ) + if update is not None: + updates.append(update) if not updates: print("Generated reference source pins are up to date.") diff --git a/tests/test_docs_env.py b/tests/test_docs_env.py new file mode 100644 index 000000000..0c0d56bb8 --- /dev/null +++ b/tests/test_docs_env.py @@ -0,0 +1,36 @@ +from __future__ import annotations + +import importlib +from pathlib import Path + + +def load_docs_env(): + return importlib.import_module("scripts.docs_env") + + +def test_repo_direnv_command_runs_x2mdx_directly_inside_nix_shell(monkeypatch) -> None: + docs_env = load_docs_env() + monkeypatch.delenv(docs_env.DIRENV_ENV_MARKER, raising=False) + monkeypatch.setenv("IN_NIX_SHELL", "pure") + + assert docs_env.repo_direnv_command(Path("/repo"), "x2mdx", "openrpc") == [ + "python3", + "-m", + "x2mdx.cli", + "openrpc", + ] + + +def test_repo_direnv_command_uses_direnv_outside_nix_shell(monkeypatch) -> None: + docs_env = load_docs_env() + monkeypatch.delenv(docs_env.DIRENV_ENV_MARKER, raising=False) + monkeypatch.delenv("IN_NIX_SHELL", raising=False) + monkeypatch.setattr(docs_env.shutil, "which", lambda name: "/bin/direnv" if name == "direnv" else None) + + assert docs_env.repo_direnv_command(Path("/repo"), "python3", "script.py") == [ + "direnv", + "exec", + "/repo", + "python3", + "script.py", + ] diff --git a/tests/test_update_generated_reference_sources.py b/tests/test_update_generated_reference_sources.py index 07e5d03e5..8582fc6fc 100644 --- a/tests/test_update_generated_reference_sources.py +++ b/tests/test_update_generated_reference_sources.py @@ -42,6 +42,25 @@ def write_source_config(path: Path, *, publish_version: str) -> None: ) +def write_wallet_gateway_source_config(path: Path, *, publish_version: str) -> None: + path.write_text( + json.dumps( + { + "source": "test", + "release_repo": "hyperledger-labs/splice-wallet-kernel", + "remote": "https://github.com/hyperledger-labs/splice-wallet-kernel.git", + "tag_prefix": "@canton-network/wallet-gateway-remote@", + "min_version": "0.24.0", + "publish_version": publish_version, + "specs": [], + }, + indent=2, + ) + + "\n", + encoding="utf-8", + ) + + def test_update_splice_openapi_source_updates_stale_publish_version(tmp_path: Path) -> None: module = load_script_module() source_config_path = tmp_path / "source-artifacts.json" @@ -103,3 +122,90 @@ def test_update_splice_openapi_source_dry_run_does_not_write(tmp_path: Path) -> assert update.previous == "0.5.18" assert update.current == "0.6.7" assert json.loads(source_config_path.read_text(encoding="utf-8"))["publish_version"] == "0.5.18" + + +def test_update_wallet_gateway_openrpc_source_updates_stale_publish_version(tmp_path: Path) -> None: + module = load_script_module() + source_config_path = tmp_path / "source-artifacts.json" + write_wallet_gateway_source_config(source_config_path, publish_version="0.25.0") + module.wallet_gateway_openrpc.stable_release_versions = lambda **_kwargs: [ + "0.25.0", + "1.4.0", + ] + + update = module.update_wallet_gateway_openrpc_source( + source_config_path=source_config_path, + dry_run=False, + ) + + assert update == module.SourceUpdate( + source="Wallet Gateway OpenRPC", + path=source_config_path, + field="publish_version", + previous="0.25.0", + current="1.4.0", + ) + assert json.loads(source_config_path.read_text(encoding="utf-8"))["publish_version"] == "1.4.0" + + +def test_update_wallet_gateway_openrpc_source_noops_when_current(tmp_path: Path) -> None: + module = load_script_module() + source_config_path = tmp_path / "source-artifacts.json" + write_wallet_gateway_source_config(source_config_path, publish_version="1.4.0") + module.wallet_gateway_openrpc.stable_release_versions = lambda **_kwargs: [ + "0.25.0", + "1.4.0", + ] + + assert ( + module.update_wallet_gateway_openrpc_source( + source_config_path=source_config_path, + dry_run=False, + ) + is None + ) + assert json.loads(source_config_path.read_text(encoding="utf-8"))["publish_version"] == "1.4.0" + + +def test_update_wallet_gateway_openrpc_source_dry_run_does_not_write(tmp_path: Path) -> None: + module = load_script_module() + source_config_path = tmp_path / "source-artifacts.json" + write_wallet_gateway_source_config(source_config_path, publish_version="0.25.0") + module.wallet_gateway_openrpc.stable_release_versions = lambda **_kwargs: [ + "0.25.0", + "1.4.0", + ] + + update = module.update_wallet_gateway_openrpc_source( + source_config_path=source_config_path, + dry_run=True, + ) + + assert update is not None + assert update.previous == "0.25.0" + assert update.current == "1.4.0" + assert json.loads(source_config_path.read_text(encoding="utf-8"))["publish_version"] == "0.25.0" + + +def test_requested_sources_defaults_to_all_sources() -> None: + module = load_script_module() + + assert module.requested_sources(type("Args", (), {"sources": None})()) == module.ALL_SOURCES + + +def test_requested_sources_preserves_order_and_deduplicates() -> None: + module = load_script_module() + + assert module.requested_sources( + type( + "Args", + (), + { + "sources": [ + "wallet-gateway-openrpc", + "splice-openapi", + "wallet-gateway-openrpc", + ] + }, + )() + ) == ("wallet-gateway-openrpc", "splice-openapi") diff --git a/tests/test_wallet_kernel_nav.py b/tests/test_wallet_kernel_nav.py index 75380731d..2d09344f6 100644 --- a/tests/test_wallet_kernel_nav.py +++ b/tests/test_wallet_kernel_nav.py @@ -128,6 +128,65 @@ def test_openrpc_nav_uses_wallet_gateway_section_shape(tmp_path: Path) -> None: ] +def test_openrpc_nav_updates_product_navigation(tmp_path: Path) -> None: + generate_wallet_gateway_openrpc_reference = load_script("generate_wallet_gateway_openrpc_reference") + docs_json = tmp_path / "docs-main" / "docs.json" + docs_json.parent.mkdir(parents=True) + docs_json.write_text( + json.dumps( + { + "navigation": { + "products": [ + { + "product": "API Reference", + "pages": [ + {"group": "TypeScript", "pages": []}, + {"group": "Wallet Kernel SDK", "pages": ["old-wallet"]}, + {"group": "Splice APIs", "pages": []}, + ], + } + ] + } + } + ), + encoding="utf-8", + ) + output_dir = docs_json.parent / "reference" / "wallet-gateway-json-rpc" + + write_mdx(output_dir / "index.mdx", "Wallet Gateway") + write_mdx(output_dir / "specs" / "user-api.mdx", "User API") + write_mdx(output_dir / "operations" / "user-api" / "createWallet.mdx", "createWallet") + write_mdx(output_dir / "operations" / "user-api" / "details.mdx", "Details and history") + write_mdx(output_dir / "operations" / "details.mdx", "Details and history") + + generate_wallet_gateway_openrpc_reference.update_docs_navigation( + docs_json_path=docs_json, + dropdown_label="API Reference", + output_dir=output_dir, + spec_entries=[{"spec_id": "user-api"}], + ) + + docs = json.loads(docs_json.read_text(encoding="utf-8")) + pages = docs["navigation"]["products"][0]["pages"] + assert pages == [ + {"group": "TypeScript", "pages": []}, + { + "group": "Wallet Gateway", + "pages": [ + { + "group": "User API", + "pages": [ + "reference/wallet-gateway-json-rpc/operations/user-api/createWallet", + "reference/wallet-gateway-json-rpc/operations/user-api/details", + ], + }, + "reference/wallet-gateway-json-rpc/operations/details", + ], + }, + {"group": "Splice APIs", "pages": []}, + ] + + def test_openrpc_nav_group_helper_omits_redundant_spec_page_child(tmp_path: Path) -> None: generated_reference_nav = load_script("generated_reference_nav") docs_json = tmp_path / "docs-main" / "docs.json"