Reshare WAAS secret shares

Reshares the MPC secret shares for the specified WAAS wallet.

POST /sdk/{environmentId}/waas/{walletId}/reshare

Reshare WAAS secret shares

cURL

curl --request POST \
  --url https://app.dynamicauth.com/api/v0/sdk/{environmentId}/waas/{walletId}/reshare \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "clientKeygenIds": [
    "<string>"
  ],
  "delegateToProjectEnvironment": true,
  "revokeDelegation": true,
  "shareSetId": "95b11417-f18f-457f-8804-68e361f9164f",
  "initialSignerRules": [
    {
      "name": "<string>",
      "ruleId": "95b11417-f18f-457f-8804-68e361f9164f",
      "address": "0xbF394748301603f18d953C90F0b087CBEC0E1834",
      "addresses": [
        "0xbF394748301603f18d953C90F0b087CBEC0E1834"
      ],
      "chainId": 123,
      "chainIds": [
        123
      ],
      "contractAbi": [
        {}
      ],
      "functionName": "<string>",
      "argumentConstraints": [
        {
          "value": "<unknown>",
          "index": 1
        }
      ],
      "valueLimit": {
        "asset": "0xbF394748301603f18d953C90F0b087CBEC0E1834",
        "maxPerCall": "<string>",
        "totalLimit": "<string>"
      },
      "operationRestrictions": {
        "blockExport": true,
        "blockRevocation": true,
        "blockClientSigning": true
      },
      "disableBlockaidSecurityChecks": true
    }
  ]
}
'

import requests

url = "https://app.dynamicauth.com/api/v0/sdk/{environmentId}/waas/{walletId}/reshare"

payload = {
    "clientKeygenIds": ["<string>"],
    "delegateToProjectEnvironment": True,
    "revokeDelegation": True,
    "shareSetId": "95b11417-f18f-457f-8804-68e361f9164f",
    "initialSignerRules": [
        {
            "name": "<string>",
            "ruleId": "95b11417-f18f-457f-8804-68e361f9164f",
            "address": "0xbF394748301603f18d953C90F0b087CBEC0E1834",
            "addresses": ["0xbF394748301603f18d953C90F0b087CBEC0E1834"],
            "chainId": 123,
            "chainIds": [123],
            "contractAbi": [{}],
            "functionName": "<string>",
            "argumentConstraints": [
                {
                    "value": "<unknown>",
                    "index": 1
                }
            ],
            "valueLimit": {
                "asset": "0xbF394748301603f18d953C90F0b087CBEC0E1834",
                "maxPerCall": "<string>",
                "totalLimit": "<string>"
            },
            "operationRestrictions": {
                "blockExport": True,
                "blockRevocation": True,
                "blockClientSigning": True
            },
            "disableBlockaidSecurityChecks": True
        }
    ]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    clientKeygenIds: ['<string>'],
    delegateToProjectEnvironment: true,
    revokeDelegation: true,
    shareSetId: '95b11417-f18f-457f-8804-68e361f9164f',
    initialSignerRules: [
      {
        name: '<string>',
        ruleId: '95b11417-f18f-457f-8804-68e361f9164f',
        address: '0xbF394748301603f18d953C90F0b087CBEC0E1834',
        addresses: ['0xbF394748301603f18d953C90F0b087CBEC0E1834'],
        chainId: 123,
        chainIds: [123],
        contractAbi: [{}],
        functionName: '<string>',
        argumentConstraints: [{value: '<unknown>', index: 1}],
        valueLimit: {
          asset: '0xbF394748301603f18d953C90F0b087CBEC0E1834',
          maxPerCall: '<string>',
          totalLimit: '<string>'
        },
        operationRestrictions: {blockExport: true, blockRevocation: true, blockClientSigning: true},
        disableBlockaidSecurityChecks: true
      }
    ]
  })
};

fetch('https://app.dynamicauth.com/api/v0/sdk/{environmentId}/waas/{walletId}/reshare', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.dynamicauth.com/api/v0/sdk/{environmentId}/waas/{walletId}/reshare",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'clientKeygenIds' => [
        '<string>'
    ],
    'delegateToProjectEnvironment' => true,
    'revokeDelegation' => true,
    'shareSetId' => '95b11417-f18f-457f-8804-68e361f9164f',
    'initialSignerRules' => [
        [
                'name' => '<string>',
                'ruleId' => '95b11417-f18f-457f-8804-68e361f9164f',
                'address' => '0xbF394748301603f18d953C90F0b087CBEC0E1834',
                'addresses' => [
                                '0xbF394748301603f18d953C90F0b087CBEC0E1834'
                ],
                'chainId' => 123,
                'chainIds' => [
                                123
                ],
                'contractAbi' => [
                                [
                                                                
                                ]
                ],
                'functionName' => '<string>',
                'argumentConstraints' => [
                                [
                                                                'value' => '<unknown>',
                                                                'index' => 1
                                ]
                ],
                'valueLimit' => [
                                'asset' => '0xbF394748301603f18d953C90F0b087CBEC0E1834',
                                'maxPerCall' => '<string>',
                                'totalLimit' => '<string>'
                ],
                'operationRestrictions' => [
                                'blockExport' => true,
                                'blockRevocation' => true,
                                'blockClientSigning' => true
                ],
                'disableBlockaidSecurityChecks' => true
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.dynamicauth.com/api/v0/sdk/{environmentId}/waas/{walletId}/reshare"

	payload := strings.NewReader("{\n  \"clientKeygenIds\": [\n    \"<string>\"\n  ],\n  \"delegateToProjectEnvironment\": true,\n  \"revokeDelegation\": true,\n  \"shareSetId\": \"95b11417-f18f-457f-8804-68e361f9164f\",\n  \"initialSignerRules\": [\n    {\n      \"name\": \"<string>\",\n      \"ruleId\": \"95b11417-f18f-457f-8804-68e361f9164f\",\n      \"address\": \"0xbF394748301603f18d953C90F0b087CBEC0E1834\",\n      \"addresses\": [\n        \"0xbF394748301603f18d953C90F0b087CBEC0E1834\"\n      ],\n      \"chainId\": 123,\n      \"chainIds\": [\n        123\n      ],\n      \"contractAbi\": [\n        {}\n      ],\n      \"functionName\": \"<string>\",\n      \"argumentConstraints\": [\n        {\n          \"value\": \"<unknown>\",\n          \"index\": 1\n        }\n      ],\n      \"valueLimit\": {\n        \"asset\": \"0xbF394748301603f18d953C90F0b087CBEC0E1834\",\n        \"maxPerCall\": \"<string>\",\n        \"totalLimit\": \"<string>\"\n      },\n      \"operationRestrictions\": {\n        \"blockExport\": true,\n        \"blockRevocation\": true,\n        \"blockClientSigning\": true\n      },\n      \"disableBlockaidSecurityChecks\": true\n    }\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://app.dynamicauth.com/api/v0/sdk/{environmentId}/waas/{walletId}/reshare")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"clientKeygenIds\": [\n    \"<string>\"\n  ],\n  \"delegateToProjectEnvironment\": true,\n  \"revokeDelegation\": true,\n  \"shareSetId\": \"95b11417-f18f-457f-8804-68e361f9164f\",\n  \"initialSignerRules\": [\n    {\n      \"name\": \"<string>\",\n      \"ruleId\": \"95b11417-f18f-457f-8804-68e361f9164f\",\n      \"address\": \"0xbF394748301603f18d953C90F0b087CBEC0E1834\",\n      \"addresses\": [\n        \"0xbF394748301603f18d953C90F0b087CBEC0E1834\"\n      ],\n      \"chainId\": 123,\n      \"chainIds\": [\n        123\n      ],\n      \"contractAbi\": [\n        {}\n      ],\n      \"functionName\": \"<string>\",\n      \"argumentConstraints\": [\n        {\n          \"value\": \"<unknown>\",\n          \"index\": 1\n        }\n      ],\n      \"valueLimit\": {\n        \"asset\": \"0xbF394748301603f18d953C90F0b087CBEC0E1834\",\n        \"maxPerCall\": \"<string>\",\n        \"totalLimit\": \"<string>\"\n      },\n      \"operationRestrictions\": {\n        \"blockExport\": true,\n        \"blockRevocation\": true,\n        \"blockClientSigning\": true\n      },\n      \"disableBlockaidSecurityChecks\": true\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.dynamicauth.com/api/v0/sdk/{environmentId}/waas/{walletId}/reshare")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"clientKeygenIds\": [\n    \"<string>\"\n  ],\n  \"delegateToProjectEnvironment\": true,\n  \"revokeDelegation\": true,\n  \"shareSetId\": \"95b11417-f18f-457f-8804-68e361f9164f\",\n  \"initialSignerRules\": [\n    {\n      \"name\": \"<string>\",\n      \"ruleId\": \"95b11417-f18f-457f-8804-68e361f9164f\",\n      \"address\": \"0xbF394748301603f18d953C90F0b087CBEC0E1834\",\n      \"addresses\": [\n        \"0xbF394748301603f18d953C90F0b087CBEC0E1834\"\n      ],\n      \"chainId\": 123,\n      \"chainIds\": [\n        123\n      ],\n      \"contractAbi\": [\n        {}\n      ],\n      \"functionName\": \"<string>\",\n      \"argumentConstraints\": [\n        {\n          \"value\": \"<unknown>\",\n          \"index\": 1\n        }\n      ],\n      \"valueLimit\": {\n        \"asset\": \"0xbF394748301603f18d953C90F0b087CBEC0E1834\",\n        \"maxPerCall\": \"<string>\",\n        \"totalLimit\": \"<string>\"\n      },\n      \"operationRestrictions\": {\n        \"blockExport\": true,\n        \"blockRevocation\": true,\n        \"blockClientSigning\": true\n      },\n      \"disableBlockaidSecurityChecks\": true\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

200

{
  "roomId": "<string>",
  "serverKeygenIds": [
    "<string>"
  ],
  "newServerKeygenIds": [
    "<string>"
  ],
  "walletId": "95b11417-f18f-457f-8804-68e361f9164f"
}

{
  "error": "<string>"
}

{
  "error": "No jwt provided!"
}

{
  "error": "Internal Server Error"
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

environmentId · string · required

ID of the environment

Required string length: 36

Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$

Example:

"95b11417-f18f-457f-8804-68e361f9164f"

walletId · string · required

UUID of the wallet

Required string length: 36

Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$

Example:

"95b11417-f18f-457f-8804-68e361f9164f"

Body

application/json

Reshare Request

clientKeygenIds · string[] · required

List of client-side key generation identifiers for resharing

A base58 string with a max length of 100 characters

Maximum string length: 100

Pattern: ^[1-9A-HJ-NP-Za-km-z]+$

oldThresholdSignatureScheme · enum<string> · required

Available options: TWO_OF_TWO, TWO_OF_THREE, THREE_OF_FIVE

newThresholdSignatureScheme · enum<string> · required

Available options: TWO_OF_TWO, TWO_OF_THREE, THREE_OF_FIVE

delegateToProjectEnvironment · boolean

Whether to delegate key access to the project environment

revokeDelegation · boolean

Whether to revoke previously delegated key access

reshareKind · enum<string>

What kind of share this ceremony is minting. When omitted, defaults to rootUser for backwards compatibility.

Available options: rootUser, cloudBackup, delegation, offlineRecovery

shareSetId · string

Identifier of the active share set this reshare ceremony runs against. Optional for backwards compatibility — when omitted, the active rootUser share set is resolved from walletId. SDKs that already receive shareSetId from getWallet() should pass it here to avoid the fallback lookup.

Required string length: 36

Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$

Example:

"95b11417-f18f-457f-8804-68e361f9164f"

initialSignerRules · object[]

Rules to seed the delegated Signer's policy layer with when this reshare mints a new delegated Signer. Only valid on the composition-mint delegation reshare path — rejected otherwise.

Maximum array length: 100

Show child attributes

Response

200

application/json

Successfully created a room for reshare ceremony

roomId · string · required

Unique identifier of the opened MPC room

serverKeygenIds · string[] · required

List of existing server-side key generation identifiers

A base58 string with a max length of 100 characters

Maximum string length: 100

Pattern: ^[1-9A-HJ-NP-Za-km-z]+$

newServerKeygenIds · string[] · required

List of newly generated server-side key generation identifiers

A base58 string with a max length of 100 characters

Maximum string length: 100

Pattern: ^[1-9A-HJ-NP-Za-km-z]+$

walletId · string

Required string length: 36

Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$

Example:

"95b11417-f18f-457f-8804-68e361f9164f"