Crypto Wallet

Overview

Authenticating with a crypto wallet requires two steps to authenticate a user. The first step is to retrieve a challenge phrase to be signed with the user's wallet, and then a second call provides that signature with that wallet address. This will return you an authenticated JWT.

Start Crypto Wallet Challenge

If you're calling either of the Crypto Wallet endpoints for the purposes of starting a Client Session, make sure you send the ratio-client-session-id header, rather than the ratio-client-id and ratio-client-secret headers.

{
    "walletAddress": "0x0000000000000000000000000000000000000000",
    "walletType": "EVM"
}

{
    "challenge": "Signing in with Ratio: pUQikKqqBq1brTwt1oHhUJwlOTfshzfMEAsJaH7x1MOdN7QMOooFfj-Aujmi7sb0wJnvYqtmZtlszKdH"
}

curl --location -g --request POST 'https://api.ratio.me/v1/auth/cryptoWallet:start' \
--header 'ratio-client-id: <YOUR_CLIENT_ID>' \
--header 'ratio-client-secret: <YOUR_CLIENT_SECRET>' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--data-raw '{
    "walletAddress": "<WALLET_ADDRESS>",
    "walletType": "EVM"
}'

Authenticate Crypto Wallet

{
    "walletAddress": "0x0000000000000000000000000000000000000000",
    "walletType": "EVM",
    "signature": "2djd2cFZ9VU2zDWvUGqeHwvbiJZfTt3BMzDctDsEW7vM2QUTgTHjeM2rpFX9ZULeic3KptUh5ehipXDFcK5ecYiX"
}

{
    "sessionJwt": "eyJhbG.....",
    "userMask": {
        "id": "00000000-0000-0000-0000-000000000000",
        "createTime": "2022-01-01T00:00:00.000Z",
        "updateTime": "2022-01-01T23:59:59.999Z",
        "phoneMask": "0000",
        "preferredMfaMethod": "OTP_SMS"
    }
}

curl --location -g --request POST 'https://api.ratio.me/v1/auth/cryptoWallet:authenticate' \
--header 'ratio-client-id: <YOUR_CLIENT_ID>' \
--header 'ratio-client-secret: <YOUR_CLIENT_SECRET>' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--data-raw '{
    "walletAddress": "<WALLET_ADDRESS>",
    "walletType": "EVM",
    "signature": "<SIGNED_CHALLENGE_STRING>"
}'

Add New Signing Wallet

{
    "walletAddress": "0x0000000000000000000000000000000000000000",
    "walletType": "EVM"
}

{}

curl --location -g --request POST 'https://api.ratio.me/v1/auth/cryptoWallet:addToUser' \
--header 'ratio-client-id: <YOUR_CLIENT_ID>' \
--header 'ratio-client-secret: <YOUR_CLIENT_SECRET>' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--data-raw '{
    "walletAddress": "<WALLET_ADDRESS>",
    "walletType": "EVM"
}'

PreviousAuth NextEmail OTP

Last updated 1 year ago

Was this helpful?

curl --location -g --request POST 'https://api.ratio.me/v1/auth/cryptoWallet:start' \ --header 'ratio-client-id: <YOUR_CLIENT_ID>' \ --header 'ratio-client-secret: <YOUR_CLIENT_SECRET>' \ --header 'Content-Type: application/json' \ --header 'Accept: application/json' \ --data-raw '{ "walletAddress": "<WALLET_ADDRESS>", "walletType": "EVM" }'

{ "walletAddress": "0x0000000000000000000000000000000000000000", "walletType": "EVM", "signature": "2djd2cFZ9VU2zDWvUGqeHwvbiJZfTt3BMzDctDsEW7vM2QUTgTHjeM2rpFX9ZULeic3KptUh5ehipXDFcK5ecYiX" }

{ "sessionJwt": "eyJhbG.....", "userMask": { "id": "00000000-0000-0000-0000-000000000000", "createTime": "2022-01-01T00:00:00.000Z", "updateTime": "2022-01-01T23:59:59.999Z", "phoneMask": "0000", "preferredMfaMethod": "OTP_SMS" } }

curl --location -g --request POST 'https://api.ratio.me/v1/auth/cryptoWallet:authenticate' \ --header 'ratio-client-id: <YOUR_CLIENT_ID>' \ --header 'ratio-client-secret: <YOUR_CLIENT_SECRET>' \ --header 'Content-Type: application/json' \ --header 'Accept: application/json' \ --data-raw '{ "walletAddress": "<WALLET_ADDRESS>", "walletType": "EVM", "signature": "<SIGNED_CHALLENGE_STRING>" }'

curl --location -g --request POST 'https://api.ratio.me/v1/auth/cryptoWallet:addToUser' \ --header 'ratio-client-id: <YOUR_CLIENT_ID>' \ --header 'ratio-client-secret: <YOUR_CLIENT_SECRET>' \ --header 'Content-Type: application/json' \ --header 'Accept: application/json' \ --data-raw '{ "walletAddress": "<WALLET_ADDRESS>", "walletType": "EVM" }'