Embed & Integrate

The Silk SDK is designed for ease of use by both seasoned Web3 devs and those new to self-custody wallets and cryptography.

1. Install

First Tab

npm i @silk-wallet/silk-wallet-sdk

Second Tab

2. Use

For New Devs

Just getting started with Web3 development? You can easily embed Silk to your site following standard practices that minimizes bugs or performance issues. Silk exposes an EIP-1193-compliant interface, so you can use it just as you would use MetaMask, one of the most common Web3 wallet services. The only difference is that Silk must be initialized.

The following code initializes Silk, presents the login modal to the user, and gets the user's wallet addresses.

import { initSilk } from "@silk-wallet/silk-wallet-sdk"

// Initialize Silk
const silk = initSilk()

// Open the Silk login modal. silk.login() will throw if the user does not log in
try {
  await silk.login()
} catch (error) {
  console.log(error)
}

// Get the user's wallet addresses
const accounts = await silk.request({ method: 'eth_requestAccounts' })

If you want to give the user other wallet options in the Silk signup screen, use the loginSelector method instead of the login method. See the Methods section for details.

For Web3 Devs

Know how to use window.ethereum and wagmi?

If you have a codebase that already uses window.ethereum or wagmi, you can still integrate Silk in a couple lines.

First, you need to initialize Silk and have the user login (as above). Then assign silk to window.ethereum.

If you are using wagmi, Silk will work with the injected connector. Just assign silk to window.ethereum, have the user log in, and then use the wagmi hooks as you would with any other wallet.

import { initSilk } from "@silk-wallet/silk-wallet-sdk"

// Initialize Silk
const silk = initSilk()
window.ethereum = silk

// wagmi's InjectedConnector will now connect to the Silk provider.

// Remember to have the user log in. If the user does not log in,
// calls to window.ethereum.request() will error out.
// silk.login() will throw if the user does not log in.
try {
  await window.ethereum.login()
} catch (error) {
  console.log(error)
}

If you want to give the user other wallet options in the Silk signup screen, use the loginSelector method instead of the login method. See the Methods section for details.

3. Example

We created a CodeSandbox so you can easily try out the SDK.

Click here to go to the sandbox.

Questions or Trouble Integrating?

Reach out to us at [e-mail] or join our telegram group to ping the developer community with your question.