import cobo_waas2
from cobo_waas2.models.key_share_holder_group import KeyShareHolderGroup
from cobo_waas2.rest import ApiException
from pprint import pprint
# See configuration.py for a list of all supported configurations.
configuration = cobo_waas2.Configuration(
# Replace `<YOUR_PRIVATE_KEY>` with your private key
api_private_key="<YOUR_PRIVATE_KEY>",
# Select the development environment. To use the production environment, change the URL to https://api.cobo.com/v2.
host="https://api.dev.cobo.com/v2",
)
# Enter a context with an instance of the API client
with cobo_waas2.ApiClient(configuration) as api_client:
# Create an instance of the API class
api_instance = cobo_waas2.WalletsMPCWalletsApi(api_client)
vault_id = "f47ac10b-58cc-4372-a567-0e02b2c3d479"
key_share_holder_group_id = "e8257ac8-76b8-4d1e-a1f9-eec4cb931dce"
try:
# Get key share holder group information
api_response = api_instance.get_key_share_holder_group_by_id(
vault_id, key_share_holder_group_id
)
print(
"The response of WalletsMPCWalletsApi->get_key_share_holder_group_by_id:\n"
)
pprint(api_response)
except Exception as e:
print(
"Exception when calling WalletsMPCWalletsApi->get_key_share_holder_group_by_id: %s\n"
% e
)
// Import classes:
import com.cobo.waas2.ApiClient;
import com.cobo.waas2.ApiException;
import com.cobo.waas2.Configuration;
import com.cobo.waas2.Env;
import com.cobo.waas2.api.WalletsMpcWalletsApi;
import com.cobo.waas2.model.*;
public class Example {
public static void main(String[] args) {
ApiClient defaultClient = Configuration.getDefaultApiClient();
// Select the development environment. To use the production environment, replace `Env.DEV` with
// `Env.PROD
defaultClient.setEnv(Env.DEV);
// Replace `<YOUR_PRIVATE_KEY>` with your private key
defaultClient.setPrivKey("<YOUR_PRIVATE_KEY>");
WalletsMpcWalletsApi apiInstance = new WalletsMpcWalletsApi();
UUID vaultId = UUID.fromString("f47ac10b-58cc-4372-a567-0e02b2c3d479");
String keyShareHolderGroupId = "e8257ac8-76b8-4d1e-a1f9-eec4cb931dce";
try {
KeyShareHolderGroup result =
apiInstance.getKeyShareHolderGroupById(vaultId, keyShareHolderGroupId);
System.out.println(result);
} catch (ApiException e) {
System.err.println("Exception when calling WalletsMpcWalletsApi#getKeyShareHolderGroupById");
System.err.println("Status code: " + e.getCode());
System.err.println("Reason: " + e.getResponseBody());
System.err.println("Response headers: " + e.getResponseHeaders());
e.printStackTrace();
}
}
}
package main
import (
"context"
"fmt"
coboWaas2 "github.com/CoboGlobal/cobo-waas2-go-sdk/cobo_waas2"
"github.com/CoboGlobal/cobo-waas2-go-sdk/cobo_waas2/crypto"
"os"
)
func main() {
vaultId := "f47ac10b-58cc-4372-a567-0e02b2c3d479"
keyShareHolderGroupId := "e8257ac8-76b8-4d1e-a1f9-eec4cb931dce"
configuration := coboWaas2.NewConfiguration()
// Initialize the API client
apiClient := coboWaas2.NewAPIClient(configuration)
ctx := context.Background()
// Select the development environment. To use the production environment, replace coboWaas2.DevEnv with coboWaas2.ProdEnv
ctx = context.WithValue(ctx, coboWaas2.ContextEnv, coboWaas2.DevEnv)
// Replace `<YOUR_PRIVATE_KEY>` with your private key
ctx = context.WithValue(ctx, coboWaas2.ContextPortalSigner, crypto.Ed25519Signer{
Secret: "<YOUR_PRIVATE_KEY>",
})
resp, r, err := apiClient.WalletsMPCWalletsAPI.GetKeyShareHolderGroupById(ctx, vaultId, keyShareHolderGroupId).
Execute()
if err != nil {
fmt.Fprintf(
os.Stderr,
"Error when calling `WalletsMPCWalletsAPI.GetKeyShareHolderGroupById``: %v\n",
err,
)
fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
}
// response from `GetKeyShareHolderGroupById`: KeyShareHolderGroup
fmt.Fprintf(
os.Stdout,
"Response from `WalletsMPCWalletsAPI.GetKeyShareHolderGroupById`: %v\n",
resp,
)
}
const CoboWaas2 = require("@cobo/cobo-waas2");
// Initialize the API client
const apiClient = CoboWaas2.ApiClient.instance;
// Select the development environment. To use the production environment, replace `Env.DEV` with `Env.PROD`
apiClient.setEnv(CoboWaas2.Env.DEV);
// Replace `<YOUR_PRIVATE_KEY>` with your private key
apiClient.setPrivateKey("<YOUR_PRIVATE_KEY>");
// Call the API
const apiInstance = new CoboWaas2.WalletsMPCWalletsApi();
const vault_id = "f47ac10b-58cc-4372-a567-0e02b2c3d479";
const key_share_holder_group_id = "e8257ac8-76b8-4d1e-a1f9-eec4cb931dce";
apiInstance
.getKeyShareHolderGroupById(vault_id, key_share_holder_group_id)
.then(
(data) => {
console.log("API called successfully. Returned data: " + data);
},
(error) => {
console.error(error);
},
);
{
"key_share_holder_group_id": "b33130a9-6e18-44a9-9e48-8b3b41921f0e",
"type": "MainGroup",
"tss_key_share_groups": [
{
"tss_key_share_group_id": "mMedDioOKhTlhGyQRzMv",
"curve": "SECP256K1",
"root_pubkey": "xpub661MyMwAqRbcG4vPNi58VQJrXW8D9VzmauuRq2rTY3oUVnKGuLTxQxvvoEXgLvZ7N9GQXQkWVgKn1rzEUUEm4NdvrBKUqjpNJEnn2UL4rYq"
}
],
"key_share_holders": [
{
"name": "Key share holder name",
"type": "API",
"tss_node_id": "coboAbCdEfGhIjKlMnOpQrStUvWxYz1234567890abcdefghi",
"online": true,
"signer": true,
"status": "Valid",
"account_id": "auth0|cobo|839305394802991371"
}
],
"participants": 3,
"threshold": 2,
"status": "Valid",
"created_timestamp": 1718619403933
}{
"error_code": 123,
"error_message": "<string>",
"error_id": "0b6ddf19083c4bd1a9ca01bec44b24dd"
}{
"error_code": 123,
"error_message": "<string>",
"error_id": "0b6ddf19083c4bd1a9ca01bec44b24dd"
}Get key share holder group information
This operation retrieves detailed information about a specified key share holder group.
import cobo_waas2
from cobo_waas2.models.key_share_holder_group import KeyShareHolderGroup
from cobo_waas2.rest import ApiException
from pprint import pprint
# See configuration.py for a list of all supported configurations.
configuration = cobo_waas2.Configuration(
# Replace `<YOUR_PRIVATE_KEY>` with your private key
api_private_key="<YOUR_PRIVATE_KEY>",
# Select the development environment. To use the production environment, change the URL to https://api.cobo.com/v2.
host="https://api.dev.cobo.com/v2",
)
# Enter a context with an instance of the API client
with cobo_waas2.ApiClient(configuration) as api_client:
# Create an instance of the API class
api_instance = cobo_waas2.WalletsMPCWalletsApi(api_client)
vault_id = "f47ac10b-58cc-4372-a567-0e02b2c3d479"
key_share_holder_group_id = "e8257ac8-76b8-4d1e-a1f9-eec4cb931dce"
try:
# Get key share holder group information
api_response = api_instance.get_key_share_holder_group_by_id(
vault_id, key_share_holder_group_id
)
print(
"The response of WalletsMPCWalletsApi->get_key_share_holder_group_by_id:\n"
)
pprint(api_response)
except Exception as e:
print(
"Exception when calling WalletsMPCWalletsApi->get_key_share_holder_group_by_id: %s\n"
% e
)
// Import classes:
import com.cobo.waas2.ApiClient;
import com.cobo.waas2.ApiException;
import com.cobo.waas2.Configuration;
import com.cobo.waas2.Env;
import com.cobo.waas2.api.WalletsMpcWalletsApi;
import com.cobo.waas2.model.*;
public class Example {
public static void main(String[] args) {
ApiClient defaultClient = Configuration.getDefaultApiClient();
// Select the development environment. To use the production environment, replace `Env.DEV` with
// `Env.PROD
defaultClient.setEnv(Env.DEV);
// Replace `<YOUR_PRIVATE_KEY>` with your private key
defaultClient.setPrivKey("<YOUR_PRIVATE_KEY>");
WalletsMpcWalletsApi apiInstance = new WalletsMpcWalletsApi();
UUID vaultId = UUID.fromString("f47ac10b-58cc-4372-a567-0e02b2c3d479");
String keyShareHolderGroupId = "e8257ac8-76b8-4d1e-a1f9-eec4cb931dce";
try {
KeyShareHolderGroup result =
apiInstance.getKeyShareHolderGroupById(vaultId, keyShareHolderGroupId);
System.out.println(result);
} catch (ApiException e) {
System.err.println("Exception when calling WalletsMpcWalletsApi#getKeyShareHolderGroupById");
System.err.println("Status code: " + e.getCode());
System.err.println("Reason: " + e.getResponseBody());
System.err.println("Response headers: " + e.getResponseHeaders());
e.printStackTrace();
}
}
}
package main
import (
"context"
"fmt"
coboWaas2 "github.com/CoboGlobal/cobo-waas2-go-sdk/cobo_waas2"
"github.com/CoboGlobal/cobo-waas2-go-sdk/cobo_waas2/crypto"
"os"
)
func main() {
vaultId := "f47ac10b-58cc-4372-a567-0e02b2c3d479"
keyShareHolderGroupId := "e8257ac8-76b8-4d1e-a1f9-eec4cb931dce"
configuration := coboWaas2.NewConfiguration()
// Initialize the API client
apiClient := coboWaas2.NewAPIClient(configuration)
ctx := context.Background()
// Select the development environment. To use the production environment, replace coboWaas2.DevEnv with coboWaas2.ProdEnv
ctx = context.WithValue(ctx, coboWaas2.ContextEnv, coboWaas2.DevEnv)
// Replace `<YOUR_PRIVATE_KEY>` with your private key
ctx = context.WithValue(ctx, coboWaas2.ContextPortalSigner, crypto.Ed25519Signer{
Secret: "<YOUR_PRIVATE_KEY>",
})
resp, r, err := apiClient.WalletsMPCWalletsAPI.GetKeyShareHolderGroupById(ctx, vaultId, keyShareHolderGroupId).
Execute()
if err != nil {
fmt.Fprintf(
os.Stderr,
"Error when calling `WalletsMPCWalletsAPI.GetKeyShareHolderGroupById``: %v\n",
err,
)
fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
}
// response from `GetKeyShareHolderGroupById`: KeyShareHolderGroup
fmt.Fprintf(
os.Stdout,
"Response from `WalletsMPCWalletsAPI.GetKeyShareHolderGroupById`: %v\n",
resp,
)
}
const CoboWaas2 = require("@cobo/cobo-waas2");
// Initialize the API client
const apiClient = CoboWaas2.ApiClient.instance;
// Select the development environment. To use the production environment, replace `Env.DEV` with `Env.PROD`
apiClient.setEnv(CoboWaas2.Env.DEV);
// Replace `<YOUR_PRIVATE_KEY>` with your private key
apiClient.setPrivateKey("<YOUR_PRIVATE_KEY>");
// Call the API
const apiInstance = new CoboWaas2.WalletsMPCWalletsApi();
const vault_id = "f47ac10b-58cc-4372-a567-0e02b2c3d479";
const key_share_holder_group_id = "e8257ac8-76b8-4d1e-a1f9-eec4cb931dce";
apiInstance
.getKeyShareHolderGroupById(vault_id, key_share_holder_group_id)
.then(
(data) => {
console.log("API called successfully. Returned data: " + data);
},
(error) => {
console.error(error);
},
);
{
"key_share_holder_group_id": "b33130a9-6e18-44a9-9e48-8b3b41921f0e",
"type": "MainGroup",
"tss_key_share_groups": [
{
"tss_key_share_group_id": "mMedDioOKhTlhGyQRzMv",
"curve": "SECP256K1",
"root_pubkey": "xpub661MyMwAqRbcG4vPNi58VQJrXW8D9VzmauuRq2rTY3oUVnKGuLTxQxvvoEXgLvZ7N9GQXQkWVgKn1rzEUUEm4NdvrBKUqjpNJEnn2UL4rYq"
}
],
"key_share_holders": [
{
"name": "Key share holder name",
"type": "API",
"tss_node_id": "coboAbCdEfGhIjKlMnOpQrStUvWxYz1234567890abcdefghi",
"online": true,
"signer": true,
"status": "Valid",
"account_id": "auth0|cobo|839305394802991371"
}
],
"participants": 3,
"threshold": 2,
"status": "Valid",
"created_timestamp": 1718619403933
}{
"error_code": 123,
"error_message": "<string>",
"error_id": "0b6ddf19083c4bd1a9ca01bec44b24dd"
}{
"error_code": 123,
"error_message": "<string>",
"error_id": "0b6ddf19083c4bd1a9ca01bec44b24dd"
}import cobo_waas2
from cobo_waas2.models.key_share_holder_group import KeyShareHolderGroup
from cobo_waas2.rest import ApiException
from pprint import pprint
# See configuration.py for a list of all supported configurations.
configuration = cobo_waas2.Configuration(
# Replace `<YOUR_PRIVATE_KEY>` with your private key
api_private_key="<YOUR_PRIVATE_KEY>",
# Select the development environment. To use the production environment, change the URL to https://api.cobo.com/v2.
host="https://api.dev.cobo.com/v2",
)
# Enter a context with an instance of the API client
with cobo_waas2.ApiClient(configuration) as api_client:
# Create an instance of the API class
api_instance = cobo_waas2.WalletsMPCWalletsApi(api_client)
vault_id = "f47ac10b-58cc-4372-a567-0e02b2c3d479"
key_share_holder_group_id = "e8257ac8-76b8-4d1e-a1f9-eec4cb931dce"
try:
# Get key share holder group information
api_response = api_instance.get_key_share_holder_group_by_id(
vault_id, key_share_holder_group_id
)
print(
"The response of WalletsMPCWalletsApi->get_key_share_holder_group_by_id:\n"
)
pprint(api_response)
except Exception as e:
print(
"Exception when calling WalletsMPCWalletsApi->get_key_share_holder_group_by_id: %s\n"
% e
)
// Import classes:
import com.cobo.waas2.ApiClient;
import com.cobo.waas2.ApiException;
import com.cobo.waas2.Configuration;
import com.cobo.waas2.Env;
import com.cobo.waas2.api.WalletsMpcWalletsApi;
import com.cobo.waas2.model.*;
public class Example {
public static void main(String[] args) {
ApiClient defaultClient = Configuration.getDefaultApiClient();
// Select the development environment. To use the production environment, replace `Env.DEV` with
// `Env.PROD
defaultClient.setEnv(Env.DEV);
// Replace `<YOUR_PRIVATE_KEY>` with your private key
defaultClient.setPrivKey("<YOUR_PRIVATE_KEY>");
WalletsMpcWalletsApi apiInstance = new WalletsMpcWalletsApi();
UUID vaultId = UUID.fromString("f47ac10b-58cc-4372-a567-0e02b2c3d479");
String keyShareHolderGroupId = "e8257ac8-76b8-4d1e-a1f9-eec4cb931dce";
try {
KeyShareHolderGroup result =
apiInstance.getKeyShareHolderGroupById(vaultId, keyShareHolderGroupId);
System.out.println(result);
} catch (ApiException e) {
System.err.println("Exception when calling WalletsMpcWalletsApi#getKeyShareHolderGroupById");
System.err.println("Status code: " + e.getCode());
System.err.println("Reason: " + e.getResponseBody());
System.err.println("Response headers: " + e.getResponseHeaders());
e.printStackTrace();
}
}
}
package main
import (
"context"
"fmt"
coboWaas2 "github.com/CoboGlobal/cobo-waas2-go-sdk/cobo_waas2"
"github.com/CoboGlobal/cobo-waas2-go-sdk/cobo_waas2/crypto"
"os"
)
func main() {
vaultId := "f47ac10b-58cc-4372-a567-0e02b2c3d479"
keyShareHolderGroupId := "e8257ac8-76b8-4d1e-a1f9-eec4cb931dce"
configuration := coboWaas2.NewConfiguration()
// Initialize the API client
apiClient := coboWaas2.NewAPIClient(configuration)
ctx := context.Background()
// Select the development environment. To use the production environment, replace coboWaas2.DevEnv with coboWaas2.ProdEnv
ctx = context.WithValue(ctx, coboWaas2.ContextEnv, coboWaas2.DevEnv)
// Replace `<YOUR_PRIVATE_KEY>` with your private key
ctx = context.WithValue(ctx, coboWaas2.ContextPortalSigner, crypto.Ed25519Signer{
Secret: "<YOUR_PRIVATE_KEY>",
})
resp, r, err := apiClient.WalletsMPCWalletsAPI.GetKeyShareHolderGroupById(ctx, vaultId, keyShareHolderGroupId).
Execute()
if err != nil {
fmt.Fprintf(
os.Stderr,
"Error when calling `WalletsMPCWalletsAPI.GetKeyShareHolderGroupById``: %v\n",
err,
)
fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
}
// response from `GetKeyShareHolderGroupById`: KeyShareHolderGroup
fmt.Fprintf(
os.Stdout,
"Response from `WalletsMPCWalletsAPI.GetKeyShareHolderGroupById`: %v\n",
resp,
)
}
const CoboWaas2 = require("@cobo/cobo-waas2");
// Initialize the API client
const apiClient = CoboWaas2.ApiClient.instance;
// Select the development environment. To use the production environment, replace `Env.DEV` with `Env.PROD`
apiClient.setEnv(CoboWaas2.Env.DEV);
// Replace `<YOUR_PRIVATE_KEY>` with your private key
apiClient.setPrivateKey("<YOUR_PRIVATE_KEY>");
// Call the API
const apiInstance = new CoboWaas2.WalletsMPCWalletsApi();
const vault_id = "f47ac10b-58cc-4372-a567-0e02b2c3d479";
const key_share_holder_group_id = "e8257ac8-76b8-4d1e-a1f9-eec4cb931dce";
apiInstance
.getKeyShareHolderGroupById(vault_id, key_share_holder_group_id)
.then(
(data) => {
console.log("API called successfully. Returned data: " + data);
},
(error) => {
console.error(error);
},
);
Authorizations
The API key. For more details, refer to API key.
In the API playground, enter your API secret, and your API key will be accordingly calculated.
Path Parameters
The vault ID, which you can retrieve by calling List all vaults.
The key share holder group ID.
Response
Successfully get mpc tss group
The data for key share holder group information.
The key share holder group ID.
"b33130a9-6e18-44a9-9e48-8b3b41921f0e"
The type of key share holder group. Possible values include:
-
MainGroup: A Main Group. -
SigningGroup: A Signing Group. -
RecoveryGroup: A Recovery Group.
Note: For MainGroup and SigningGroup, a Cobo key share holder will be added automatically.
MainGroup, SigningGroup, RecoveryGroup "MainGroup"
Show child attributes
Show child attributes
Show child attributes
Show child attributes
The number of key share holders in this key share holder group.
3
The number of key share holders required to approve each operation in this key share holder group.
2
The status of the key share holder group. Possible values include:
-
New: The key share holder group has been newly created. The status will becomeValidafter you call Create TSS request and specifying this key share holder group as the target key share holder group. -
Valid: The key share holder group is valid. -
Unavailable: The key share holder group is currently unavailable. This status appears when a key share holder uses mobile co-signer to change node. For example, when a key share holder changes to a new phone or loses their phone, and is in the process of setting up Cobo Guard on their new phone.
New, Valid, Unavailable "Valid"
The key share holder group's creation time in Unix timestamp format, measured in milliseconds.
1718619403933
Was this page helpful?
