Skip to main content
POST
/
platform
/
admin
/
tenant
/
wallets
/
multisignature
/
add
Add existing multisignature wallet
curl --request POST \
  --url https://api.example.com/platform/admin/tenant/wallets/multisignature/add \
  --header 'Content-Type: application/json' \
  --data '
{
  "tenantId": 1024,
  "walletName": "My Wallet",
  "walletAddress": "0x1234567890abcdef1234567890abcdef12345678",
  "blockchainId": 137
}
'
{
  "isSuccess": true,
  "isFailure": false,
  "error": null,
  "value": {
    "id": 42,
    "name": "Example"
  }
}

​
Description

Imports and registers a multisignature wallet that already exists on the blockchain. This operation does not deploy a new wallet but connects an existing deployed multisignature wallet to the platform system for management and monitoring.

​
Input

Expects a JSON body containing:
  • tenantId (long, required) - Identifier of the tenant that will manage the wallet
  • walletName (string, required) - Display name for the wallet
  • walletAddress (string, required) - Address of the existing multisignature wallet on the blockchain
  • blockchainId (long, required) - Identifier of the blockchain network where the wallet is deployed

​
Output

Returns a containing:
  • walletTenantId (long) - Unique identifier for the registered wallet tenant record
  • walletAddress (string) - The multisignature wallet address
  • walletName (string) - The assigned wallet name
  • blockchainId (long) - The blockchain network identifier
  • threshold (int) - The wallet’s signature threshold (retrieved from blockchain)
  • ownersCount (int) - Number of owners (retrieved from blockchain)

​
Examples

Request 
{
  "tenantId": 1024,
  "walletName": "Imported Safe Wallet",
  "walletAddress": "0x9876543210fedcba9876543210fedcba98765432",
  "blockchainId": 1
}
Response (200 OK) 
{
  "walletTenantId": 4096,
  "walletAddress": "0x9876543210fedcba9876543210fedcba98765432",
  "walletName": "Imported Safe Wallet",
  "blockchainId": 1,
  "threshold": 3,
  "ownersCount": 5
}

​
Errors

  • 400 Bad Request: Invalid wallet address, address is not a multisignature wallet, or wallet configuration cannot be read from blockchain.
  • 401 Unauthorized: Authentication token is missing or invalid.
  • 403 Forbidden: User does not have permission to add wallets for the specified tenant.
  • 409 Conflict: The wallet address is already registered in the system.
  • 500 Internal Server Error: An unexpected error occurred while importing the wallet.

​
Notes

The system validates that the address corresponds to a multisignature wallet and retrieves owner and threshold information from the blockchain. This operation is useful for importing wallets created outside the platform or migrating existing multisignature wallets into the system.

Query Parameters

​
api-version
string | null

Body

application/json

Request containing the existing wallet details to be added.

Request to create a new externally owned account (EOA) wallet.

​
tenantId
integer<int64>

Identifier of the tenant that will own the wallet.

Example:

1024

​
walletName
string

Name to assign to the wallet.

Example:

"My Wallet"

​
walletAddress
string

Blockchain address of the wallet.

Example:

"0x1234567890abcdef1234567890abcdef12345678"

​
blockchainId
integer<int64>

Identifier of the blockchain network where the wallet exists.

Example:

137

Response

Multisignature wallet added successfully.

Wrapper for API operation results containing success status, error information, and return value.

​
isSuccess
boolean

True if the operation completed successfully, false otherwise.

Example:

true

​
isFailure
boolean

True if the operation failed, false otherwise.

Example:

false

​
error
object

Error information returned when the operation fails.

Example:
{
  "code": "ValidationError",
  "message": "The request parameters failed validation.",
  "info": [
    "The Name field is required.",
    "The Id field must be greater than 0."
  ]
}
​
value
object

The result value returned when the operation is successful.

Example:
{
  "id": 2048,
  "walletAddress": "0x1234567890abcdef1234567890abcdef12345678",
  "blockchainId": 137
}