Create a new Web3 connection.

Initiate a new Web3 connection.

• Note: After this succeeds, make a request to PUT /v1/connections/wc/{id} (below) to approve or reject the new Web3 connection.

POST /connections/wc

TypeScript

TypeScript

const response: Promise<FireblocksResponse<CreateConnectionResponse>> = fireblocks.web3Connections.create(web3ConnectionsApiCreateRequest);

201

{
  "id": "4e9e7051-f3b2-48e9-8ee6-b12492552657",
  "sessionMetadata": {
    "appUrl": "<string>",
    "appName": "<string>",
    "appDescription": "<string>",
    "appIcon": "<string>"
  }
}

Headers

Idempotency-Key · string

A unique identifier for the request. If the request is sent multiple times with the same idempotency key, the server will return the same response as the first request. The idempotency key is valid for 24 hours.

X-End-User-Wallet-Id · string<uuid>

Unique ID of the End-User wallet to the API request. Required for end-user wallet operations.

Body

application/json

Option 1

Option 2

vaultAccountId · number · required

The ID of the vault to connect to the dApp.

Example:

1

feeLevel · enum<string> · required

The default fee level. Valid values are MEDIUM and HIGH.

Available options: MEDIUM, HIGH

Example:

"MEDIUM"

uri · string · required

The WalletConnect uri provided by the dapp.

Example:

"wc:77752975-906f-48f5-b59f-047826ee947e@1?bridge=https%3A%2F%2F0.bridge.walletconnect.org&key=64be99adc6086b7a729b0ec8c7e1f174927ab92e84f5c6f9527050225344a637"

chainIds · string[]

The IDs of the blockchain networks used in the Web3 connection (Currently required in V1 connections only).

Example:

["ETH"]

Response

201

application/json

Web3 connection initiated successfully

id · string · required

The ID of the Web3 connection initiated.

Example:

"4e9e7051-f3b2-48e9-8ee6-b12492552657"

sessionMetadata · object · required

Metadata of the Web3 connection (provided by the DApp).

Show child attributes