ConnectWallet

Connect Wallet

Allows Wallet connection from a Mobile device.

Request

URL: /v1/wallet-connections/{connectionId}

Method: GET

Path Parameters:

Parameter	Type	Description
connectionId	string	UUID of the connection.

Query Parameters: None

Headers:

Authorization: Bearer {accessToken}

Accept: application/json

Content: None

✅ Success Response

Code: 200 OK

Headers:

Content-Type: application/json

Content:

Field	Type	Description	Condition
id	string	UUID of the Connection.	Always
createdAt	string	Date and time when the Connection was created (ISO-8601 format).	Always
stakeAddress	string	Stake address of the connected wallet.	Always

Content example:

{
    "id": "7bd2862f-8deb-4814-8943-156d9dab80dd",
    "createdAt": "2024-03-17T20:47:55.738918",
    "stakeAddress": "stake1uyqnx5kzvrqkm437xsqat8defa4je5coyptl1m3hp94xs6t2ngh6c"
}

❌ Error Responses

1. Unauthorized

Code: 401 UNAUTHORIZED

Condition: If {accessToken} is invalid or expired.

2. Forbidden

Code: 403 FORBIDDEN

Condition: If another User is already connected.

Headers:

Content-Type: application/json

Content example:

{
    "code": 403,
    "description": "Forbidden",
    "cause": "Already connected to another User"
}

3. Not Found

Code: 404 NOT FOUND

Condition: If the specified Connection is not found.

Headers:

Content-Type: application/json

Content example:

{
    "code": 404,
    "description": "Not Found",
    "cause": "Entity WalletConnectionEntity, id=d0907e3d-a9a7-43b1-93dc-f3b0ee929021 not found in the database"
}

See Also

Generate Wallet Connection Challenge

Answer Wallet Connection Challenge

Generate Wallet Connection QR Code

Disconnect Wallet

Get Wallet Connections