diff --git a/.github/workflows/update-version-dashboard.yml b/.github/workflows/update-version-dashboard.yml index 4e50007ca..a9fe8f0fb 100644 --- a/.github/workflows/update-version-dashboard.yml +++ b/.github/workflows/update-version-dashboard.yml @@ -23,75 +23,9 @@ 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: Detect changes - id: changes - run: | - if [[ -n "$(git status --porcelain)" ]]; then - echo "has_changes=true" >> "$GITHUB_OUTPUT" - git status --short - git diff --stat - else - echo "has_changes=false" >> "$GITHUB_OUTPUT" - fi - - - name: Check whitespace - if: steps.changes.outputs.has_changes == 'true' - run: git diff --check - - - name: Create or update pull request - if: steps.changes.outputs.has_changes == 'true' + - name: Generate update pull requests env: GH_TOKEN: ${{ github.token }} - PR_BRANCH: version-dashboard/update - PR_TITLE: Update version dashboard data - run: | - set -euo pipefail - - git config user.name "github-actions[bot]" - 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 commit -m "$PR_TITLE" - - if remote_sha="$(git ls-remote --heads origin "$PR_BRANCH" | awk '{print $1}')" && [[ -n "$remote_sha" ]]; then - git push --force-with-lease="refs/heads/$PR_BRANCH:$remote_sha" origin "HEAD:$PR_BRANCH" - else - git push origin "HEAD:$PR_BRANCH" - fi - - pr_body="$(mktemp)" - cat > "$pr_body" <<'EOF' - Updates the committed Canton Network version dashboard data from public network, package, and installer sources. - - Validation run by the workflow: - - `npm run generate:version-compatibility-dashboard` - - `git diff --check` - EOF - - existing_pr_number="$( - gh pr list \ - --repo "$GITHUB_REPOSITORY" \ - --head "$PR_BRANCH" \ - --base main \ - --state open \ - --json number \ - --jq '.[0].number // empty' - )" - - if [[ -n "$existing_pr_number" ]]; then - gh pr edit "$existing_pr_number" \ - --repo "$GITHUB_REPOSITORY" \ - --title "$PR_TITLE" \ - --body-file "$pr_body" - else - gh pr create \ - --base main \ - --head "$PR_BRANCH" \ - --repo "$GITHUB_REPOSITORY" \ - --title "$PR_TITLE" \ - --body-file "$pr_body" - fi + GITHUB_TOKEN: ${{ github.token }} + PR_BASE_BRANCH: ${{ github.ref_name }} + run: python3 scripts/update_generated_reference_prs.py 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_network_component_versions.py b/scripts/generate_network_component_versions.py index 1612cb65e..f15c7e155 100644 --- a/scripts/generate_network_component_versions.py +++ b/scripts/generate_network_component_versions.py @@ -5,11 +5,13 @@ import argparse import html import json +import os import re import subprocess import sys from datetime import datetime, timezone from pathlib import Path +from urllib.parse import urlparse from urllib.request import Request, urlopen @@ -119,8 +121,17 @@ def parse_args() -> argparse.Namespace: return parser.parse_args() +def request_headers(url: str) -> dict[str, str]: + headers = {"User-Agent": USER_AGENT} + token = os.environ.get("GITHUB_TOKEN") or os.environ.get("GH_TOKEN") + if token and urlparse(url).netloc == "api.github.com": + headers["Authorization"] = f"Bearer {token}" + headers["X-GitHub-Api-Version"] = "2022-11-28" + return headers + + def request_url(url: str, timeout: float): - request = Request(url, headers={"User-Agent": USER_AGENT}) + request = Request(url, headers=request_headers(url)) return urlopen(request, timeout=timeout) 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/summarize_version_changes.py b/scripts/summarize_version_changes.py new file mode 100644 index 000000000..f7b969d4f --- /dev/null +++ b/scripts/summarize_version_changes.py @@ -0,0 +1,165 @@ +#!/usr/bin/env python3 + +from __future__ import annotations + +import argparse +import json +import sys +from pathlib import Path +from typing import Any + + +NETWORK_LABELS = { + "mainnet": "MainNet", + "testnet": "TestNet", + "devnet": "DevNet", +} + +COMPONENT_LABELS = { + "splice": "Splice", + "damlSdk": "Canton / Daml SDK", + "pqs": "PQS", + "tokenStandard": "Token Standard", + "walletSdk": "Wallet SDK", + "dappSdk": "dApp SDK", + "walletGateway": "Wallet Gateway", +} + + +def load_json(path: Path) -> dict[str, Any]: + payload = json.loads(path.read_text(encoding="utf-8")) + if not isinstance(payload, dict): + raise ValueError(f"Expected JSON object in {path}") + return payload + + +def format_value(value: Any) -> str: + if isinstance(value, str): + return value + return json.dumps(value, sort_keys=True) + + +def repository_version_changes(before: dict[str, Any], after: dict[str, Any]) -> list[str]: + changes: list[str] = [] + before_repositories = before.get("repositories") + after_repositories = after.get("repositories") + if not isinstance(before_repositories, dict) or not isinstance(after_repositories, dict): + return changes + + for component_key in sorted(after_repositories): + before_component = before_repositories.get(component_key) + after_component = after_repositories.get(component_key) + if not isinstance(before_component, dict) or not isinstance(after_component, dict): + continue + before_mapping = before_component.get("versionMapping") + after_mapping = after_component.get("versionMapping") + if not isinstance(before_mapping, dict) or not isinstance(after_mapping, dict): + continue + + component_label = COMPONENT_LABELS.get(component_key, component_key) + for network_key in sorted(after_mapping): + before_network = before_mapping.get(network_key) + after_network = after_mapping.get(network_key) + if not isinstance(before_network, dict) or not isinstance(after_network, dict): + continue + + before_version = before_network.get("externalVersion") + after_version = after_network.get("externalVersion") + if before_version != after_version: + network_label = NETWORK_LABELS.get(network_key, network_key) + changes.append( + f"- {network_label} {component_label}: " + f"{format_value(before_version)} -> {format_value(after_version)}" + ) + return changes + + +def dar_version_changes(before: dict[str, Any], after: dict[str, Any]) -> list[str]: + changes: list[str] = [] + before_versions = before.get("versions") + after_versions = after.get("versions") + if not isinstance(before_versions, dict) or not isinstance(after_versions, dict): + return changes + + for network_key in sorted(after_versions): + before_network = before_versions.get(network_key) + after_network = after_versions.get(network_key) + if not isinstance(before_network, dict) or not isinstance(after_network, dict): + continue + before_advanced = before_network.get("advanced") + after_advanced = after_network.get("advanced") + if not isinstance(before_advanced, dict) or not isinstance(after_advanced, dict): + continue + before_dars = { + item.get("name"): item.get("version") + for item in before_advanced.get("darVersions", []) + if isinstance(item, dict) + } + after_dars = { + item.get("name"): item.get("version") + for item in after_advanced.get("darVersions", []) + if isinstance(item, dict) + } + for package_name in sorted(after_dars): + if before_dars.get(package_name) != after_dars.get(package_name): + network_label = NETWORK_LABELS.get(network_key, network_key) + changes.append( + f"- {network_label} {package_name} DAR: " + f"{format_value(before_dars.get(package_name))} -> {format_value(after_dars.get(package_name))}" + ) + return changes + + +def dashboard_changes(before_path: Path, after_path: Path) -> list[str]: + before = load_json(before_path) + after = load_json(after_path) + return repository_version_changes(before, after) + dar_version_changes(before, after) + + +def source_config_changes(before_path: Path, after_path: Path, *, label: str) -> list[str]: + before = load_json(before_path) + after = load_json(after_path) + changes: list[str] = [] + for field in ("publish_version", "min_version"): + if before.get(field) != after.get(field): + changes.append( + f"- {label} {field}: {format_value(before.get(field))} -> {format_value(after.get(field))}" + ) + return changes + + +def print_changes(changes: list[str]) -> None: + if changes: + print("\n".join(changes)) + else: + print("- No version values changed.") + + +def parse_args() -> argparse.Namespace: + parser = argparse.ArgumentParser(description="Summarize before/after version changes as Markdown bullets.") + subparsers = parser.add_subparsers(dest="command", required=True) + + dashboard = subparsers.add_parser("dashboard", help="Summarize repo-version-config.json changes.") + dashboard.add_argument("before", type=Path) + dashboard.add_argument("after", type=Path) + + source_config = subparsers.add_parser("source-config", help="Summarize generated-reference source config changes.") + source_config.add_argument("before", type=Path) + source_config.add_argument("after", type=Path) + source_config.add_argument("--label", required=True) + return parser.parse_args() + + +def main() -> int: + args = parse_args() + if args.command == "dashboard": + print_changes(dashboard_changes(args.before, args.after)) + elif args.command == "source-config": + print_changes(source_config_changes(args.before, args.after, label=args.label)) + else: + raise AssertionError(f"Unhandled command: {args.command}") + return 0 + + +if __name__ == "__main__": + sys.exit(main()) diff --git a/scripts/update_generated_reference_prs.py b/scripts/update_generated_reference_prs.py new file mode 100644 index 000000000..f1a26bed3 --- /dev/null +++ b/scripts/update_generated_reference_prs.py @@ -0,0 +1,321 @@ +#!/usr/bin/env python3 + +from __future__ import annotations + +import argparse +import os +import subprocess +import sys +import tempfile +from dataclasses import dataclass +from pathlib import Path +from typing import Sequence + +import summarize_version_changes + + +REPO_ROOT = Path(__file__).resolve().parents[1] + + +@dataclass(frozen=True) +class UpdateSurface: + key: str + title: str + branch: str + description: str + generate_commands: tuple[tuple[str, ...], ...] + paths: tuple[str, ...] + summary_kind: str + summary_path: str + summary_label: str | None + validation: tuple[str, ...] + + +SURFACES = ( + UpdateSurface( + key="version-dashboard", + title="Update version dashboard data", + branch="version-dashboard/update", + description=( + "Updates the committed Canton Network version dashboard data from public network, " + "package, and installer sources." + ), + generate_commands=(("nix-shell", "--run", "npm run generate:version-compatibility-dashboard"),), + paths=( + "config/repo-version-config.json", + "docs-main/snippets/generated/version-dashboard-data.mdx", + ), + summary_kind="dashboard", + summary_path="config/repo-version-config.json", + summary_label=None, + validation=( + "npm run generate:version-compatibility-dashboard", + "git diff --check", + ), + ), + UpdateSurface( + key="wallet-gateway-openrpc", + title="Update Wallet Gateway OpenRPC reference", + branch="generated-references/wallet-gateway-openrpc/update", + description=( + "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." + ), + generate_commands=( + ("nix-shell", "--run", "npm run update:generated-reference-sources -- --source wallet-gateway-openrpc"), + ("nix-shell", "--run", "npm run generate:wallet-gateway-openrpc-reference"), + ), + paths=( + "config/x2mdx/wallet-gateway-openrpc/source-artifacts.json", + "docs-main/docs.json", + "docs-main/reference/wallet-gateway-json-rpc", + ), + summary_kind="source-config", + summary_path="config/x2mdx/wallet-gateway-openrpc/source-artifacts.json", + summary_label="Wallet Gateway OpenRPC", + validation=( + "npm run update:generated-reference-sources -- --source wallet-gateway-openrpc", + "npm run generate:wallet-gateway-openrpc-reference", + "git diff --check", + ), + ), +) + + +def generated_clean_paths() -> tuple[str, ...]: + paths = {".internal"} + for surface in SURFACES: + paths.update(surface.paths) + return tuple(sorted(paths)) + + +def run(command: Sequence[str], *, capture: bool = False) -> str: + kwargs: dict[str, object] = { + "cwd": REPO_ROOT, + "check": True, + "text": True, + } + if capture: + kwargs["stdout"] = subprocess.PIPE + completed = subprocess.run(list(command), **kwargs) + return completed.stdout.strip() if capture else "" + + +def git(*args: str, capture: bool = False) -> str: + return run(("git", *args), capture=capture) + + +def gh(*args: str, capture: bool = False) -> str: + return run(("gh", *args), capture=capture) + + +def base_branch_from_environment() -> str: + base_branch = os.environ.get("PR_BASE_BRANCH") or os.environ.get("GITHUB_REF_NAME") + if not base_branch: + raise RuntimeError("PR_BASE_BRANCH or GITHUB_REF_NAME must be set") + return base_branch + + +def repository_from_environment() -> str: + repository = os.environ.get("GITHUB_REPOSITORY") + if not repository: + raise RuntimeError("GITHUB_REPOSITORY must be set") + return repository + + +def body_markdown(*, surface: UpdateSurface, changes: list[str]) -> str: + change_text = "\n".join(changes) if changes else "- No version values changed." + validation = "\n".join(f"- `{command}`" for command in surface.validation) + return ( + f"{surface.description}\n\n" + f"Version changes:\n" + f"{change_text}\n\n" + f"Validation run by the workflow:\n" + f"{validation}\n" + ) + + +def summarize_surface_changes(surface: UpdateSurface, before_path: Path) -> list[str]: + after_path = REPO_ROOT / surface.summary_path + if surface.summary_kind == "dashboard": + return summarize_version_changes.dashboard_changes(before_path, after_path) + if surface.summary_kind == "source-config": + if surface.summary_label is None: + raise ValueError(f"Surface {surface.key} must define summary_label") + return summarize_version_changes.source_config_changes( + before_path, + after_path, + label=surface.summary_label, + ) + raise ValueError(f"Unknown summary kind for {surface.key}: {surface.summary_kind}") + + +def reset_to_base(base_sha: str) -> None: + git("switch", "--detach", base_sha) + git("reset", "--hard", base_sha) + git("clean", "-fd", "--", *generated_clean_paths()) + + +def write_base_file(base_sha: str, relative_path: str) -> Path: + before = tempfile.NamedTemporaryFile("w", encoding="utf-8", delete=False) + before_path = Path(before.name) + before.write(git("show", f"{base_sha}:{relative_path}", capture=True)) + before.close() + return before_path + + +def has_surface_changes(surface: UpdateSurface) -> bool: + output = git("status", "--porcelain", "--", *surface.paths, capture=True) + return bool(output) + + +def push_branch(branch: str) -> None: + remote_output = git("ls-remote", "--heads", "origin", branch, capture=True) + remote_sha = remote_output.split()[0] if remote_output else "" + if remote_sha: + git("push", f"--force-with-lease=refs/heads/{branch}:{remote_sha}", "origin", f"HEAD:{branch}") + else: + git("push", "origin", f"HEAD:{branch}") + + +def create_or_update_pull_request( + *, + surface: UpdateSurface, + body_path: Path, + base_branch: str, + repository: str, +) -> None: + if not has_surface_changes(surface): + print(f"No changes for {surface.title}") + return + + git("status", "--short", "--", *surface.paths) + git("switch", "-c", surface.branch) + git("add", "--", *surface.paths) + git("diff", "--cached", "--stat") + git("diff", "--cached", "--check") + git("commit", "-m", surface.title) + push_branch(surface.branch) + + existing_pr_number = gh( + "pr", + "list", + "--repo", + repository, + "--head", + surface.branch, + "--base", + base_branch, + "--state", + "open", + "--json", + "number", + "--jq", + ".[0].number // empty", + capture=True, + ) + if existing_pr_number: + gh( + "pr", + "edit", + existing_pr_number, + "--repo", + repository, + "--title", + surface.title, + "--body-file", + str(body_path), + ) + subprocess.run( + [ + "gh", + "pr", + "ready", + existing_pr_number, + "--repo", + repository, + "--undo", + ], + cwd=REPO_ROOT, + check=False, + ) + return + + gh( + "pr", + "create", + "--base", + base_branch, + "--head", + surface.branch, + "--repo", + repository, + "--draft", + "--title", + surface.title, + "--body-file", + str(body_path), + ) + + +def process_surface(*, surface: UpdateSurface, base_sha: str, base_branch: str, repository: str) -> None: + reset_to_base(base_sha) + before_path = write_base_file(base_sha, surface.summary_path) + + for command in surface.generate_commands: + run(command) + + changes = summarize_surface_changes(surface, before_path) + with tempfile.NamedTemporaryFile("w", encoding="utf-8", delete=False) as body_file: + body_path = Path(body_file.name) + body_path.write_text(body_markdown(surface=surface, changes=changes), encoding="utf-8") + create_or_update_pull_request( + surface=surface, + body_path=body_path, + base_branch=base_branch, + repository=repository, + ) + + +def parse_args() -> argparse.Namespace: + parser = argparse.ArgumentParser(description="Generate separate update PRs for generated docs surfaces.") + parser.add_argument( + "--surface", + action="append", + choices=tuple(surface.key for surface in SURFACES), + help="Limit execution to a surface. Repeat to include multiple surfaces. Defaults to all surfaces.", + ) + parser.add_argument("--base-branch") + parser.add_argument("--repository") + args = parser.parse_args() + args.base_branch = args.base_branch or base_branch_from_environment() + args.repository = args.repository or repository_from_environment() + return args + + +def selected_surfaces(surface_keys: Sequence[str] | None) -> tuple[UpdateSurface, ...]: + if not surface_keys: + return SURFACES + requested = tuple(dict.fromkeys(surface_keys)) + return tuple(surface for surface in SURFACES if surface.key in requested) + + +def main() -> int: + args = parse_args() + git("config", "user.name", "github-actions[bot]") + git("config", "user.email", "41898282+github-actions[bot]@users.noreply.github.com") + base_sha = git("rev-parse", "HEAD", capture=True) + + for surface in selected_surfaces(args.surface): + process_surface( + surface=surface, + base_sha=base_sha, + base_branch=args.base_branch, + repository=args.repository, + ) + return 0 + + +if __name__ == "__main__": + sys.exit(main()) 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_generate_network_component_versions.py b/tests/test_generate_network_component_versions.py index b766d59a3..ce8916c21 100644 --- a/tests/test_generate_network_component_versions.py +++ b/tests/test_generate_network_component_versions.py @@ -171,6 +171,26 @@ def test_latest_stable_version_ignores_prerelease_and_debug_tags() -> None: ) +def test_request_headers_use_github_token_for_github_api(monkeypatch) -> None: + module = load_script_module() + monkeypatch.setenv("GITHUB_TOKEN", "test-token") + + assert module.request_headers("https://api.github.com/repos/example/project/releases") == { + "User-Agent": module.USER_AGENT, + "Authorization": "Bearer test-token", + "X-GitHub-Api-Version": "2022-11-28", + } + + +def test_request_headers_do_not_send_github_token_to_other_hosts(monkeypatch) -> None: + module = load_script_module() + monkeypatch.setenv("GITHUB_TOKEN", "test-token") + + assert module.request_headers("https://registry.npmjs.org/example") == { + "User-Agent": module.USER_AGENT, + } + + def test_parse_dars_lock_selects_latest_dashboard_packages_only() -> None: module = load_script_module() dars_lock = """ diff --git a/tests/test_summarize_version_changes.py b/tests/test_summarize_version_changes.py new file mode 100644 index 000000000..7920b15ea --- /dev/null +++ b/tests/test_summarize_version_changes.py @@ -0,0 +1,89 @@ +from __future__ import annotations + +import importlib.util +import json +import sys +from pathlib import Path +from types import ModuleType + + +REPO_ROOT = Path(__file__).resolve().parents[1] + + +def load_script_module() -> ModuleType: + script_path = REPO_ROOT / "scripts" / "summarize_version_changes.py" + spec = importlib.util.spec_from_file_location(script_path.stem, script_path) + assert spec is not None + assert spec.loader is not None + module = importlib.util.module_from_spec(spec) + sys.modules[script_path.stem] = module + spec.loader.exec_module(module) + return module + + +def write_json(path: Path, payload: dict) -> None: + path.write_text(json.dumps(payload, indent=2) + "\n", encoding="utf-8") + + +def dashboard_payload(*, splice_version: str, dar_version: str) -> dict: + return { + "repositories": { + "splice": { + "versionMapping": { + "mainnet": {"externalVersion": splice_version}, + "testnet": {"externalVersion": splice_version}, + } + }, + "walletGateway": { + "versionMapping": { + "mainnet": {"externalVersion": "1.4.0"}, + } + }, + }, + "versions": { + "mainnet": { + "advanced": { + "darVersions": [ + {"name": "splice-wallet", "version": dar_version}, + ] + } + } + }, + } + + +def test_dashboard_changes_summarizes_component_and_dar_versions(tmp_path: Path) -> None: + module = load_script_module() + before = tmp_path / "before.json" + after = tmp_path / "after.json" + write_json(before, dashboard_payload(splice_version="0.6.5", dar_version="0.1.18")) + write_json(after, dashboard_payload(splice_version="0.6.7", dar_version="0.1.19")) + + assert module.dashboard_changes(before, after) == [ + "- MainNet Splice: 0.6.5 -> 0.6.7", + "- TestNet Splice: 0.6.5 -> 0.6.7", + "- MainNet splice-wallet DAR: 0.1.18 -> 0.1.19", + ] + + +def test_dashboard_changes_reports_no_changes(tmp_path: Path) -> None: + module = load_script_module() + before = tmp_path / "before.json" + after = tmp_path / "after.json" + payload = dashboard_payload(splice_version="0.6.5", dar_version="0.1.18") + write_json(before, payload) + write_json(after, payload) + + assert module.dashboard_changes(before, after) == [] + + +def test_source_config_changes_summarizes_publish_version(tmp_path: Path) -> None: + module = load_script_module() + before = tmp_path / "before.json" + after = tmp_path / "after.json" + write_json(before, {"publish_version": "0.25.0", "min_version": "0.24.0"}) + write_json(after, {"publish_version": "1.4.0", "min_version": "0.24.0"}) + + assert module.source_config_changes(before, after, label="Wallet Gateway OpenRPC") == [ + "- Wallet Gateway OpenRPC publish_version: 0.25.0 -> 1.4.0" + ] diff --git a/tests/test_update_generated_reference_prs.py b/tests/test_update_generated_reference_prs.py new file mode 100644 index 000000000..5e8218b59 --- /dev/null +++ b/tests/test_update_generated_reference_prs.py @@ -0,0 +1,70 @@ +from __future__ import annotations + +import importlib.util +import sys +from pathlib import Path +from types import ModuleType + + +REPO_ROOT = Path(__file__).resolve().parents[1] + + +def load_script_module() -> ModuleType: + script_path = REPO_ROOT / "scripts" / "update_generated_reference_prs.py" + scripts_dir = str(script_path.parent) + if scripts_dir not in sys.path: + sys.path.insert(0, scripts_dir) + spec = importlib.util.spec_from_file_location(script_path.stem, script_path) + assert spec is not None + assert spec.loader is not None + module = importlib.util.module_from_spec(spec) + sys.modules[script_path.stem] = module + spec.loader.exec_module(module) + return module + + +def test_selected_surfaces_defaults_to_all_surfaces() -> None: + module = load_script_module() + + assert module.selected_surfaces(None) == module.SURFACES + + +def test_selected_surfaces_preserves_declared_surface_order() -> None: + module = load_script_module() + + surfaces = module.selected_surfaces(["wallet-gateway-openrpc", "version-dashboard"]) + + assert [surface.key for surface in surfaces] == ["version-dashboard", "wallet-gateway-openrpc"] + + +def test_generated_clean_paths_include_surface_paths_and_internal_output() -> None: + module = load_script_module() + + clean_paths = module.generated_clean_paths() + + assert ".internal" in clean_paths + assert "docs-main/reference/wallet-gateway-json-rpc" in clean_paths + assert "docs-main/snippets/generated/version-dashboard-data.mdx" in clean_paths + + +def test_body_markdown_includes_description_changes_and_validation() -> None: + module = load_script_module() + surface = next(surface for surface in module.SURFACES if surface.key == "wallet-gateway-openrpc") + + body = module.body_markdown( + surface=surface, + changes=["- Wallet Gateway OpenRPC publish_version: 0.25.0 -> 1.4.0"], + ) + + assert body.startswith("Updates the Wallet Gateway OpenRPC source pin") + assert "Version changes:\n- Wallet Gateway OpenRPC publish_version: 0.25.0 -> 1.4.0" in body + assert "- `npm run generate:wallet-gateway-openrpc-reference`" in body + + +def test_body_markdown_notes_when_no_versions_changed() -> None: + module = load_script_module() + surface = next(surface for surface in module.SURFACES if surface.key == "version-dashboard") + + body = module.body_markdown(surface=surface, changes=[]) + + assert "Version changes:\n- No version values changed." in body 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"