Start Crypto Wallet Authentication

// POST /v1/crypto_wallets/authenticate/start
const stytch = require('stytch');

const client = new stytch.Client({
  project_id: '${projectId}',
  secret: '${secret}',
});

const params = {
  crypto_wallet_type: "ethereum",
  crypto_wallet_address: "0x6df2dB4Fb3DA35d241901Bd53367770BF03123f1",
};

client.CryptoWallets.AuthenticateStart(params)
  .then(resp => { console.log(resp) })
  .catch(err => { console.log(err) });

// POST /v1/crypto_wallets/authenticate/start
package main

import (
	"context"
	"log"

	"github.com/stytchauth/stytch-go/v18/stytch/consumer/cryptowallets"
	"github.com/stytchauth/stytch-go/v18/stytch/consumer/stytchapi"
)

func main() {
	client, err := stytchapi.NewClient(
		"${projectId}",
		"${secret}",
	)
	if err != nil {
		log.Fatalf("error instantiating client: %v", err)
	}

	params := &cryptowallets.AuthenticateStartParams{
		CryptoWalletType:    "ethereum",
		CryptoWalletAddress: "0x6df2dB4Fb3DA35d241901Bd53367770BF03123f1",
	}

	resp, err := client.CryptoWallets.AuthenticateStart(context.Background(), params)
	if err != nil {
		log.Fatalf("error in method call: %v", err)
	}

	log.Println(resp)
}

// POST /v1/crypto_wallets/authenticate/start
package com.example;

import com.stytch.java.common.StytchResult;
import com.stytch.java.consumer.models.cryptowallets.AuthenticateStartRequest;
import com.stytch.java.consumer.StytchClient;

public class Main {
    public static void main(String[] args) {
        StytchClient.configure("${projectId}", "${secret}");

        AuthenticateStartRequest params = new AuthenticateStartRequest();
        params.setCryptoWalletType("ethereum");
        params.setCryptoWalletAddress("0x6df2dB4Fb3DA35d241901Bd53367770BF03123f1");

        Object result = StytchClient.getCryptoWallets().authenticateStart(params);
        if (result instanceof StytchResult.Success) {
          System.out.println(((StytchResult.Success) result).getValue());
        } else {
          System.out.println(((StytchResult.Error) result).getException());
        }
    }
}

// POST /v1/crypto_wallets/authenticate/start
package com.example

import com.stytch.java.consumer.StytchClient
import com.stytch.java.consumer.models.cryptowallets.AuthenticateStartRequest

fun main() {
    StytchClient.configure(
        projectId = "${projectId}",
        secret = "${secret}",
    )

    when (
        val result =
            StytchClient.cryptoWallets.authenticateStart(
                AuthenticateStartRequest(
                    cryptoWalletType = "ethereum",
                    cryptoWalletAddress = "0x6df2dB4Fb3DA35d241901Bd53367770BF03123f1",
                ),
            )
    ) {
        is StytchResult.Success -> println(result.value)
        is StytchResult.Error -> println(result.exception)
    }
}

// POST /v1/crypto_wallets/authenticate/start
const stytch = require('stytch');

const client = new stytch.Client({
  project_id: '${projectId}',
  secret: '${secret}',
});

const params = {
  crypto_wallet_type: "ethereum",
  crypto_wallet_address: "0x6df2dB4Fb3DA35d241901Bd53367770BF03123f1",
};

client.cryptoWallets.authenticateStart(params)
  .then(resp => { console.log(resp) })
  .catch(err => { console.log(err) });

# POST /v1/crypto_wallets/authenticate/start
from stytch import Client

client = Client(
    project_id="${projectId}",
    secret="${secret}",
)

resp = client.crypto_wallets.authenticate_start(
    crypto_wallet_type="ethereum",
    crypto_wallet_address="0x6df2dB4Fb3DA35d241901Bd53367770BF03123f1",
)

print(resp)

# frozen_string_literal: true

# POST /v1/crypto_wallets/authenticate/start
require 'stytch'

client = Stytch::Client.new(
  project_id: "${projectId}",
  secret: "${secret}"
)

resp = client.crypto_wallets.authenticate_start(
  crypto_wallet_type: "ethereum",
  crypto_wallet_address: "0x6df2dB4Fb3DA35d241901Bd53367770BF03123f1"
  
)

puts resp

// POST /v1/crypto_wallets/authenticate/start
use stytch::consumer::client::Client;
use stytch::consumer::crypto_wallets::AuthenticateStartRequest;

fn main() {
    let client = Client::new("${projectId}", "${secret}").unwrap();
    let resp = client.crypto_wallets.authenticate_start(
        AuthenticateStartRequest{
            crypto_wallet_type: "ethereum",
            crypto_wallet_address: "0x6df2dB4Fb3DA35d241901Bd53367770BF03123f1",
            ..Default::default()
        }
    ).await;
    println!("The response is {:?}", resp);
}

# POST /v1/crypto_wallets/authenticate/start
curl --request POST \
  --url https://test.stytch.com/v1/crypto_wallets/authenticate/start \
  -u '${projectId}:${secret}' \
  -H 'Content-Type: application/json' \
  -d '{
    "crypto_wallet_type": "ethereum",
    "crypto_wallet_address": "0x6df2dB4Fb3DA35d241901Bd53367770BF03123f1"
  }'

{
  "request_id": "<string>",
  "user_id": "<string>",
  "challenge": "<string>",
  "user_created": true,
  "status_code": 123
}

{
  "status_code": 401,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "unauthorized_credentials",
  "error_message": "Unauthorized credentials.",
  "error_url": "https://stytch.com/docs/api/errors/401"
}

{
  "status_code": 429,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "too_many_requests",
  "error_message": "Too many requests have been made.",
  "error_url": "https://stytch.com/docs/api/errors/429"
}

{
  "status_code": 500,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "internal_server_error",
  "error_message": "Oops, something seems to have gone wrong, please reach out to support@stytch.com to let us know what went wrong.",
  "error_url": "https://stytch.com/docs/api/errors/500"
}

POST

crypto_wallets

authenticate

start

// POST /v1/crypto_wallets/authenticate/start
const stytch = require('stytch');

const client = new stytch.Client({
  project_id: '${projectId}',
  secret: '${secret}',
});

const params = {
  crypto_wallet_type: "ethereum",
  crypto_wallet_address: "0x6df2dB4Fb3DA35d241901Bd53367770BF03123f1",
};

client.CryptoWallets.AuthenticateStart(params)
  .then(resp => { console.log(resp) })
  .catch(err => { console.log(err) });

// POST /v1/crypto_wallets/authenticate/start
package main

import (
	"context"
	"log"

	"github.com/stytchauth/stytch-go/v18/stytch/consumer/cryptowallets"
	"github.com/stytchauth/stytch-go/v18/stytch/consumer/stytchapi"
)

func main() {
	client, err := stytchapi.NewClient(
		"${projectId}",
		"${secret}",
	)
	if err != nil {
		log.Fatalf("error instantiating client: %v", err)
	}

	params := &cryptowallets.AuthenticateStartParams{
		CryptoWalletType:    "ethereum",
		CryptoWalletAddress: "0x6df2dB4Fb3DA35d241901Bd53367770BF03123f1",
	}

	resp, err := client.CryptoWallets.AuthenticateStart(context.Background(), params)
	if err != nil {
		log.Fatalf("error in method call: %v", err)
	}

	log.Println(resp)
}

// POST /v1/crypto_wallets/authenticate/start
package com.example;

import com.stytch.java.common.StytchResult;
import com.stytch.java.consumer.models.cryptowallets.AuthenticateStartRequest;
import com.stytch.java.consumer.StytchClient;

public class Main {
    public static void main(String[] args) {
        StytchClient.configure("${projectId}", "${secret}");

        AuthenticateStartRequest params = new AuthenticateStartRequest();
        params.setCryptoWalletType("ethereum");
        params.setCryptoWalletAddress("0x6df2dB4Fb3DA35d241901Bd53367770BF03123f1");

        Object result = StytchClient.getCryptoWallets().authenticateStart(params);
        if (result instanceof StytchResult.Success) {
          System.out.println(((StytchResult.Success) result).getValue());
        } else {
          System.out.println(((StytchResult.Error) result).getException());
        }
    }
}

// POST /v1/crypto_wallets/authenticate/start
package com.example

import com.stytch.java.consumer.StytchClient
import com.stytch.java.consumer.models.cryptowallets.AuthenticateStartRequest

fun main() {
    StytchClient.configure(
        projectId = "${projectId}",
        secret = "${secret}",
    )

    when (
        val result =
            StytchClient.cryptoWallets.authenticateStart(
                AuthenticateStartRequest(
                    cryptoWalletType = "ethereum",
                    cryptoWalletAddress = "0x6df2dB4Fb3DA35d241901Bd53367770BF03123f1",
                ),
            )
    ) {
        is StytchResult.Success -> println(result.value)
        is StytchResult.Error -> println(result.exception)
    }
}

// POST /v1/crypto_wallets/authenticate/start
const stytch = require('stytch');

const client = new stytch.Client({
  project_id: '${projectId}',
  secret: '${secret}',
});

const params = {
  crypto_wallet_type: "ethereum",
  crypto_wallet_address: "0x6df2dB4Fb3DA35d241901Bd53367770BF03123f1",
};

client.cryptoWallets.authenticateStart(params)
  .then(resp => { console.log(resp) })
  .catch(err => { console.log(err) });

# POST /v1/crypto_wallets/authenticate/start
from stytch import Client

client = Client(
    project_id="${projectId}",
    secret="${secret}",
)

resp = client.crypto_wallets.authenticate_start(
    crypto_wallet_type="ethereum",
    crypto_wallet_address="0x6df2dB4Fb3DA35d241901Bd53367770BF03123f1",
)

print(resp)

# frozen_string_literal: true

# POST /v1/crypto_wallets/authenticate/start
require 'stytch'

client = Stytch::Client.new(
  project_id: "${projectId}",
  secret: "${secret}"
)

resp = client.crypto_wallets.authenticate_start(
  crypto_wallet_type: "ethereum",
  crypto_wallet_address: "0x6df2dB4Fb3DA35d241901Bd53367770BF03123f1"
  
)

puts resp

// POST /v1/crypto_wallets/authenticate/start
use stytch::consumer::client::Client;
use stytch::consumer::crypto_wallets::AuthenticateStartRequest;

fn main() {
    let client = Client::new("${projectId}", "${secret}").unwrap();
    let resp = client.crypto_wallets.authenticate_start(
        AuthenticateStartRequest{
            crypto_wallet_type: "ethereum",
            crypto_wallet_address: "0x6df2dB4Fb3DA35d241901Bd53367770BF03123f1",
            ..Default::default()
        }
    ).await;
    println!("The response is {:?}", resp);
}

# POST /v1/crypto_wallets/authenticate/start
curl --request POST \
  --url https://test.stytch.com/v1/crypto_wallets/authenticate/start \
  -u '${projectId}:${secret}' \
  -H 'Content-Type: application/json' \
  -d '{
    "crypto_wallet_type": "ethereum",
    "crypto_wallet_address": "0x6df2dB4Fb3DA35d241901Bd53367770BF03123f1"
  }'

{
  "request_id": "<string>",
  "user_id": "<string>",
  "challenge": "<string>",
  "user_created": true,
  "status_code": 123
}

{
  "status_code": 401,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "unauthorized_credentials",
  "error_message": "Unauthorized credentials.",
  "error_url": "https://stytch.com/docs/api/errors/401"
}

{
  "status_code": 429,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "too_many_requests",
  "error_message": "Too many requests have been made.",
  "error_url": "https://stytch.com/docs/api/errors/429"
}

{
  "status_code": 500,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "internal_server_error",
  "error_message": "Oops, something seems to have gone wrong, please reach out to support@stytch.com to let us know what went wrong.",
  "error_url": "https://stytch.com/docs/api/errors/500"
}

After calling this endpoint, the user will need to sign a message containing the returned challenge field. For Ethereum crypto wallets, you can optionally use the Sign In With Ethereum (SIWE) protocol for the message by passing in the siwe_params. The only required fields are domain and uri. If the crypto wallet detects that the domain in the message does not match the website’s domain, it will display a warning to the user. If not using the SIWE protocol, the message will simply consist of the project name and a random string.

Authorizations

Authorization

string

header

required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Body

application/json

Request type

crypto_wallet_type

string

required

The type of wallet to authenticate. Currently ethereum and solana are supported. Wallets for any EVM-compatible chains (such as Polygon or BSC) are also supported and are grouped under the ethereum type.

crypto_wallet_address

string

required

The crypto wallet address to authenticate.

user_id

string

The unique ID of a specific User. You may use an external_id here if one is set for the user.

session_token

string

The session_token associated with a User's existing Session.

session_jwt

string

The session_jwt associated with a User's existing Session.

siwe_params

object

The parameters for a Sign In With Ethereum (SIWE) message. May only be passed if the crypto_wallet_type is ethereum.

Show child attributes

Response

Successful response

request_id

string

required

Globally unique UUID that is returned with every API call. This value is important to log for debugging purposes; we may ask for this value to help identify a specific API call when helping you debug an issue.

user_id

string

required

The unique ID of the affected User.

challenge

string

required

A challenge string to be signed by the wallet in order to prove ownership.

user_created

boolean

required

In login_or_create endpoints, this field indicates whether or not a User was just created.

status_code

integer<int32>

required

The HTTP status code of the response. Stytch follows standard HTTP response status code patterns, e.g. 2XX values equate to success, 3XX values are redirects, 4XX are client errors, and 5XX are server errors.

Endpoints

Resources

Start Crypto Wallet Authentication

Authorizations

Body

Response