🔗Link a Wallet to a Web 2.0 Account

Picket can be used to verify wallet ownership for a user in an existing application. Once you've linked a wallet to a user's account, you start integrating web3 information into your app!

Link a Wallet to an Existing Account

In addition to enabling you to build new web3 native experiences from scratch, Picket can adapt your existing traditional web applications to the modern web3 world. Picket's authentication flow verifies wallet ownership, which allows you to link a wallet address to a user's profile. Once you've connected a wallet address to a user, you can integrate web3 information, like NFTs, into the user's profile by querying the blockchain all while knowing that the user is the owner of the verified wallet!

Steps

1. Setup Picket

2. Verify Wallet Ownership Client-Side with picket-js or picket-react

3. Make a request to the app's server with the Picket access token

4. Validate the user's access token server-side

5. Link the wallet to the user's account

1. Setup Picket

Get your API keys

Join the Waitlist

To manage demand, we set up a waitlist for API key access. We're granting developers access as fast as we can. If you haven't already signed up, you can add yourself to the waitlist at picketapi.com.

Picket uses API keys to authorize your requests. Requests without an API key will result in an error. You can get your API key from your account dashboard. There are two types of API keys

• Publishable keys: These keys are used client-side and are meant for client-side libraries, like picket-js.

• Secret keys: As the name suggests, these must be kept secret. They are meant for server-side libraries, like picket-node

Authorization to the API is performed via HTTP Basic Auth. Provide your API key as the basic auth username value. You do not need to provide a password. API Authorization is handled for you in any of Picket's SDKs.

Curl

curl https://picketapi.com/v1/{any_endpoint}
    -u pk_123_456_your_key 

Javascript

import Picket from "@picketapi/picket-js"
const picket = new Picket('YOUR_PUBLISHABLE_KEY_HERE')

Install the Picket SDK

The best way to interact with our API is to use one of our official libraries:

Client-side (Browser) Libraries

• picket-js

• picket-react

Server-side Libraries

• picket-node

Javascript

# Install via NPM
npm install --save "@picketapi/picket-js"

React

# Install via NPM
npm install --save "@picketapi/picket-react" 

Node

# Install via NPM
npm install --save "@picketapi/picket-node"

Want to use Picket with other web-frameworks? Let us know at [e-mail]

2. Verify Wallet Ownership Client-Side with picket-js or picket-react

Follow the Wallet Authentication guide

3. Make a request to the app's server with the Picket access token

Replace example.com and the example access token with your app's server route

Curl

curl example.com \
 -H 'Authorization: Bearer x.y.z'

Javascript/Typescript

const accessToken = "x.y.z"

await fetch("example.com", {
    method: "GET",
    headers: {
        Authorization: `Bearer ${accessToken}`
    }
});

4. Validate the user's access token server-side

Server-side libraries, like picket-node, require a secret API key and must only be used in a secure, server-side environment.

Node

import Picket from "@picketapi/picket-node";

const picket = new Picket("sk_demo123");

// REPLACE code to get access token from client request
const accessToken = "";

try {
    const { walletAddress } = await picket.validate(accessToken);
    // save user's wallet address to the DB
} catch (err) {
    console.error("invalid access token!");
}

API

If there isn't a Picket server-side SDK for you language of choice, you can still use the Picket API

import requests

# REPLACE code to get access token from client request
access_token = '';

resp = requests.get(
    'https://picketapi.com/api/v1/auth/validate', 
    auth=('YOUR_PROJECT_SECRET_KEY', '')
)

# check for HTPP status code OK 
# extract wallet address

5. Link the wallet to the user's account

// Psuedo-code for saving a wallet address to a user's profile
const { walletAddress } = accessToken; 
db.updateUserProfile({ walletAddress });