Dfns Typescript SDK

https://github.com/dfns/dfns-sdk-ts
Admin
The Dfns Typescript SDK provides client libraries and tools for interacting with the Dfns API,...
Tokens:105,252
Snippets:613
Trust Score:7.1
License:MIT
Update:1 week ago
Show doc for...
Tokens:
Raw
### Run the React Example

Source: https://github.com/dfns/dfns-sdk-ts/blob/m/examples/sdk/import-export-wallet-react/README.md

Commands to install dependencies and start the React development server for the import/export wallet example.

```bash
# inside repo root
npm install

cd examples/sdk/import-export-wallet-react
npm install
npm run start
```

--------------------------------

### Run the export wallet example

Source: https://github.com/dfns/dfns-sdk-ts/blob/m/examples/sdk/export-wallet/README.md

Commands to install dependencies and run the example from the repo root and the example directory.

```bash
# inside repo root
npm install

cd examples/sdk/export-wallet
npm install
npm run exec
```

--------------------------------

### Install example dependencies

Source: https://github.com/dfns/dfns-sdk-ts/blob/m/examples/sdk/nextjs-delegated/README.md

Install dependencies specifically for the nextjs-delegated example.

```bash
cd examples/sdk/nextjs-delegated
npm i
```

--------------------------------

### Run Example Commands

Source: https://github.com/dfns/dfns-sdk-ts/blob/m/examples/sdk/import-wallet/README.md

Commands to install dependencies and execute the import wallet example from the repository root.

```bash
# inside repo root
npm install

cd examples/sdk/import-wallet
npm install
npm run exec
```

--------------------------------

### Run the server

Source: https://github.com/dfns/dfns-sdk-ts/blob/m/examples/sdk/auth-delegated-key-credential/README.md

Install dependencies and start the server backend.

```bash
server %  npm install
server %  npm run start
```

--------------------------------

### Run the Import HD Wallet Example

Source: https://github.com/dfns/dfns-sdk-ts/blob/m/examples/sdk/import-hd-wallet/README.md

Commands to install dependencies and run the example from the repository root and the example directory.

```bash
# inside repo root
npm install

cd examples/sdk/import-hd-wallet
npm install
npm run exec
```

--------------------------------

### Install dependencies

Source: https://github.com/dfns/dfns-sdk-ts/blob/m/examples/sdk/nextjs-delegated-recovery/README.md

Commands to install dependencies at the repository root and in the example directory.

```bash
npm i
```

```bash
cd examples/sdk/nextjs-delegated-recovery
npm i
```

```bash
npm run dev
```

--------------------------------

### Run the web frontend

Source: https://github.com/dfns/dfns-sdk-ts/blob/m/examples/sdk/auth-social/README.md

Commands to install dependencies and start the frontend development server.

```bash
auth-social %  npm install
auth-social %  npm run start
```

--------------------------------

### Run the web frontend

Source: https://github.com/dfns/dfns-sdk-ts/blob/m/examples/sdk/auth-delegated-key-credential/README.md

Install dependencies and start the React SPA frontend.

```bash
web %  npm install
web %  npm run start
```

--------------------------------

### Start metro server (iOS and Android)

Source: https://github.com/dfns/dfns-sdk-ts/blob/m/examples/sdk/auth-delegated/README.md

First install npm dependencies and then start the metro server. This command is used for both iOS and Android before building the app.

```bash
mobile %  npm install
mobile %  npm run start

```

--------------------------------

### Install SDK dependencies

Source: https://github.com/dfns/dfns-sdk-ts/blob/m/examples/sdk/service-account/README.md

Install the required @dfns/sdk and @dfns/sdk-keysigner packages using npm or yarn.

```sh
// npm
npm i @dfns/sdk @dfns/sdk-keysigner

// yarn
yarn add @dfns/sdk @dfns/sdk-keysigner
```

--------------------------------

### Run the gasless transaction example

Source: https://github.com/dfns/dfns-sdk-ts/blob/m/examples/libs/viem/alchemy-aa-gasless/README.md

Run the example with ts-node main.ts. The output shows the smart account address, user operation hash, and transaction hash for the sponsored mint.

```shell
> ts-node main.ts

Smart account address: 0x5b477Dc7ce2b04BAa86b917C9959012C40E81746
User operation hash: 0x82eab109825d59e572bc07c80830c620e4b2ba1817c43883f64626c3a6217162
Transaction hash: 0xd4efa8781506f905a434bc03bedf6e4701179c4b405487ee117ae3de29ea62e7
```

--------------------------------

### Run the Algorand asset transfer example

Source: https://github.com/dfns/dfns-sdk-ts/blob/m/examples/libs/algorand/asset-tx/README.md

Command to run the TypeScript example and the expected output showing the opt-in, transfer, and opt-out transactions.

```shell
> ts-node main.ts

algorand receiver address: EWACQVBHSDU2IRTIHJIHOTAI3OT4R2AF4IWHUPLL3BKK42ROLS46WLNQQY
algorand sender address: MZR5RZ3YNFUVXIWP77DUVRX4N75UU2NTGQMGV2ITDUZI46YE5RS5IXRBDQ
receiver didn't optin for the asset... creating optin transaction
transaction signed
optin transaction broadcasted: RX7OMCWOMHDZI64DP42DAPX3KPKSNPWEDZALERIRD6P3TCM5TNSQ
optin transaction confirmed
sending 1 USDC
transaction signed
USDC transfer broadcasted: NWHJG5LXTQKGFRNTIZYGZRW7KHMRN5SVYPIUMRGHSV6HAOUHG2HQ
opt-out for the asset
transaction signed
USDC optout broadcasted: ALP6WTZQVTMOW5DTBNIQMKBS5BAZ2RZTCNXC5HBTKUQFCABQNZQQ
optout transaction confirmed
```

--------------------------------

### Run development server

Source: https://github.com/dfns/dfns-sdk-ts/blob/m/examples/sdk/nextjs-delegated/README.md

Start the Next.js development server.

```bash
npm run dev
```

--------------------------------

### Install and execute the DvP script

Source: https://github.com/dfns/dfns-sdk-ts/blob/m/examples/libs/canton/dvp/README.md

Commands to install dependencies and run the DvP script after configuring the .env file.

```shell
npm install
npm run exec
```

--------------------------------

### Run the Algorand multisig transaction example

Source: https://github.com/dfns/dfns-sdk-ts/blob/m/examples/libs/algorand/multisig-tx/README.md

Command to run the example with ts-node. The output shows the two wallet addresses, the created multisig address, the signing steps, and the submitted transaction ID.

```shell
> ts-node main.ts

first algorand address: MZR5RZ3YNFUVXIWP77DUVRX4N75UU2NTGQMGV2ITDUZI46YE5RS5IXRBDQ
second algorand address: EWACQVBHSDU2IRTIHJIHOTAI3OT4R2AF4IWHUPLL3BKK42ROLS46WLNQQY
Created MultiSig Address:  3V6PXCCW3IM5BVJS5SVFMJXWEELTZDDR7NXN4CGI5B2IY2M4LFRTURV2Q4
native transaction signed by wallet 1
native transaction signed by wallet 2
transaction submitted: PEKMYV7IJD47DAQPOPAGFQIYSBFZ3BBCNINGNCH2NDG7XM3E6UKA
```

--------------------------------

### Install dependencies

Source: https://github.com/dfns/dfns-sdk-ts/blob/m/examples/sdk/nextjs-delegated/README.md

Install project dependencies at the repository root.

```bash
npm i
```

--------------------------------

### Run trustline example with ts-node

Source: https://github.com/dfns/dfns-sdk-ts/blob/m/examples/libs/xrpl/trustlines/README.md

Run the example with `ts-node main.ts`. The output shows the sender address, prepared transaction, and transaction submission details.

```shell
> ts-node main.ts

xrpl sender address: rLaWJQYtUwWaQDPQxj8ztfAmQp1XH62CxX
prepared transaction: {
  "TransactionType": "TrustSet",
  "LimitAmount": {
    "issuer": "rHuGNhqTG32mfmAvWA8hUyWRLV3tCSwKQt",
    "currency": "5553444300000000000000000000000000000000",
    "value": "10000000"
  },
  "Account": "rLaWJQYtUwWaQDPQxj8ztfAmQp1XH62CxX",
  "Flags": 0,
  "Sequence": 12658679,
  "Fee": "12",
  "LastLedgerSequence": 12658720
}
transaction signed
transaction submitted: 924E016818DDFAAA4B84E81E1CD0C7E89BDB9F35035408A4D49E752110BE7DB9
```

--------------------------------

### Run XRP transfer example with ts-node

Source: https://github.com/dfns/dfns-sdk-ts/blob/m/examples/libs/xrpl/basic-tx/README.md

Run the example with `ts-node main.ts`. The output shows the sender address, prepared transaction, and the transaction hash after submission.

```shell
> ts-node main.ts

xrpl sender address: rpAR2vcGYk5zFvpt6nhgqPNf8XkCAHwKyi
prepared transaction: { xxxxxx }
transaction signed
transaction submitted: 5DF5D272B09C92A01C9780A3DD21321650920E69CDBFE35A68F402F58364393E
```

--------------------------------

### Install @dfns/sdk with npm

Source: https://github.com/dfns/dfns-sdk-ts/blob/m/README.md

Install the Dfns SDK package. Node version 18 or greater is recommended.

```bash
npm i @dfns/sdk
```

--------------------------------

### Initialize DfnsWallet with Vechain SDK

Source: https://github.com/dfns/dfns-sdk-ts/blob/m/packages/lib-vechain/README.md

This setup routine demonstrates how to initialize the DfnsWallet by configuring the DfnsApiClient, AsymmetricKeySigner, and the Vechain ThorClient.

```typescript
import { DfnsWallet } from '@dfns/lib-vechain'
import { DfnsApiClient } from '@dfns/sdk'
import { AsymmetricKeySigner } from '@dfns/sdk-keysigner'
import { Address } from '@vechain/sdk-core'
import { ThorClient, VeChainProvider } from '@vechain/sdk-network'

const signer = new AsymmetricKeySigner({
  credId: process.env.DFNS_CRED_ID!,
  privateKey: process.env.DFNS_PRIVATE_KEY!,
})

const dfnsClient = new DfnsApiClient({
  orgId: process.env.DFNS_ORG_ID!,
  authToken: process.env.DFNS_AUTH_TOKEN!,
  baseUrl: process.env.DFNS_API_URL!,
  signer,
})

const thorClient = ThorClient.at(process.env.VECHAIN_NODE_URL!)
const provider = new VeChainProvider(thorClient)

return DfnsWallet.init({
  walletId: process.env.VECHAIN_WALLET_ID!,
  dfnsClient,
},
  provider)
```

--------------------------------

### Setup DfnsWallet with viem

Source: https://github.com/dfns/dfns-sdk-ts/blob/m/packages/lib-viem/README.md

Initializes a DfnsWallet with a DfnsApiClient and AsymmetricKeySigner, then creates a viem wallet client. Requires environment variables for private key, credential ID, org ID, auth token, API URL, and wallet ID.

```typescript
import { DfnsWallet } from '@dfns/lib-viem'
import { DfnsApiClient } from '@dfns/sdk'
import { AsymmetricKeySigner } from '@dfns/sdk-keysigner'
import { createWalletClient } from 'viem'
import { toAccount } from 'viem/accounts'

const signer = new AsymmetricKeySigner({
  privateKey: process.env.DFNS_PRIVATE_KEY!,
  credId: process.env.DFNS_CRED_ID!,
})

const dfnsClient = new DfnsApiClient({
  orgId: process.env.DFNS_ORG_ID!,
  authToken: process.env.DFNS_AUTH_TOKEN!,
  baseUrl: process.env.DFNS_API_URL!,
  signer,
})

const wallet = await DfnsWallet.init({
  walletId: process.env.DFNS_WALLET_ID!,
  dfnsClient,
})

const account = toAccount(wallet)
const client = createWalletClient({
  account,
  chain: mainnet,
  transport: http(),
})
```

--------------------------------

### Run the gasless transaction example

Source: https://github.com/dfns/dfns-sdk-ts/blob/m/examples/libs/viem/zerodev-aa-gasless/README.md

Execute the main script to create a smart account and send a gasless transaction. The output shows the smart account address and transaction hash.

```shell
> ts-node main.ts

Smart account address: 0xbf9F1E7787F05cf62FA131Ab5607f67dF5c5a09a
Transaction hash: 0xcb57cd79cab48241bb438d96f2ff70ab922493cfa02f25938dd5c7f47f26e2a1
```

--------------------------------

### Run the Concordium ID App WalletConnect example

Source: https://github.com/dfns/dfns-sdk-ts/blob/m/examples/libs/concordium/wallet-activation-id-app/README.md

Run the example with ts-node main.ts. The program displays a QR code to scan with the Concordium ID app, prompts for a 4-character code, and then activates the wallet. The output shows the wallet public key, session approval, account creation request, and activation status.

```shell
> ts-node main.ts

Concordium wallet public key 8b8c91c4d0b1234567890abcdef1234567890abcdef1234567890abcdef123456
Please scan the following QR code to connect the IdApp:

█▀▀▀▀▀█ ▄█▀██▀▀█ █▀▀▀▀▀█
█ ███ █ ██▀▄▀▀▄█ █ ███ █
█ ▀▀▀ █ ▄█▀██▄▀▄ █ ▀▀▀ █
▀▀▀▀▀▀▀ ▀ ▀ █▄▀ ▀ ▀▀▀▀▀▀▀
██▄▄▄▄▀ ▄█▀▄▀█▄█ ▄▀█▄▀▄█
▄██▄██▀ ▀▄▄▀██▄▄█▀▄█▀▀▀█
▀▀▀▀▀▀▀ ▀▀▀▀▀▀▀▀▀ ▀▀▀▀▀▀▀

Session approved
Please enter the following code in the app: AB12

Proceed with account creation? (y/n): y
Sending account creation request with public_key 8b8c91c4d0b1234567890abcdef1234567890abcdef1234567890abcdef123456

Activating account... (address: ccd-address)
transaction id: tx-01jcg-m1j1k-enfb5lr8gqg2qrud
waiting for wallet to be active... it can take a few minutes.
Current wallet status: Inactive
Current wallet status: Active
Wallet is now active!
Disconnected from WalletConnect session.
```

--------------------------------

### Run the Canton Coin transfer example

Source: https://github.com/dfns/dfns-sdk-ts/blob/m/examples/libs/canton/basic-tx/README.md

Executes the example with ts-node, printing the wallet address, network, Dfns transaction id, and Canton updateId.

```shell
> ts-node main.ts

Wallet address: dfnsdev1::12200b177c740e0bf3ef985a6be16d7c4bc1960943334f5f4fbd026f97fa96b053f9
Network: CantonDevnet
Dfns transaction id tx-4aibo-eqfio-8sipe8movpq3vbhr
Canton updateId 12201412b9505ad5d6e739791affbdee33e6becb0989d2a1e53e6469f20ce37d63fa
```

--------------------------------

### Run the Bitcoin transfer example

Source: https://github.com/dfns/dfns-sdk-ts/blob/m/examples/libs/bitcoinjs/basic-tx/README.md

Executes the main.ts file with ts-node. The output shows the wallet address, unspent balance, transfer amount, fee, and transaction hash.

```shell
> ts-node main.ts

Wallet address: tb1qydad3w30lkvj7m4u02ec3emlqr7g05wf5456q3
Unspent balance: 1442078 satoshis
Transfer amount: 1 satoshis
Transfer fee: 150 satoshis
Transaction hash: 090bcfd381ff1698c94cf62ac9c99f4298c97b7aca873ce3c8a17a815ead62c3
```

--------------------------------

### Run staking example with ts-node main.ts

Source: https://github.com/dfns/dfns-sdk-ts/blob/m/examples/libs/solana/staking/README.md

Command to run the staking example. The output shows the authority, stake account, created transaction, balance, status, selected validator, delegation transaction, and final status.

```shell
> ts-node main.ts

Authority: D1FRN8fYGKsrEj5ZtsHDbksZ6xFbmsDeUNYBn8Xn46nT
Stake account: 8HwdrUPCBryfxzNDsAXsSBU67yegpyZ12H38UNXD6Vja
Stake account created: 2dsD4PiUbCpKQ7CisdFqaVpfnYqbTP2U1Cg3EwdddtBFPDi5NdGsrQakAXmxnLZyejScJCCveNT15BwQuDKBFtST
Stake account balance: 100000000
Stake account status: inactive
Selected validator: i7NyKBMJCA9bLM2nsGyAGCKHECuR2L5eh4GqFciuwNT
Delegated stake to validator: 5uTvWD5zVxBNaxahoS1r3prNrHnt9kBoR3xf7NXJ4oswLHkXX6eau4SG3vDftSaAaSNRVgDetLAowkaft55cvvcj
Stake account status: activating
```

--------------------------------

### Initialize DfnsWallet with DfnsApiClient and AsymmetricKeySigner

Source: https://github.com/dfns/dfns-sdk-ts/blob/m/packages/lib-cosmjs/README.md

Shows a typical setup routine for creating a DfnsWallet instance. It requires environment variables for private key, credential ID, org ID, auth token, and API URL. The wallet uses generateSignature to sign transactions, which you must broadcast yourself.

```typescript
import { DfnsWallet } from '@dfns/lib-cosmjs'
import { DfnsApiClient } from '@dfns/sdk'
import { AsymmetricKeySigner } from '@dfns/sdk-keysigner'

const signer = new AsymmetricKeySigner({
  privateKey: process.env.DFNS_PRIVATE_KEY!,
  credId: process.env.DFNS_CRED_ID!,
})

const dfnsClient = new DfnsApiClient({
  orgId: process.env.DFNS_ORG_ID!,
  authToken: process.env.DFNS_AUTH_TOKEN!,
  baseUrl: process.env.DFNS_API_URL!,
  signer,
})

return DfnsWallet.init({
  walletId,
  dfnsClient,
})
```

--------------------------------

### Run the Multicall example with ts-node

Source: https://github.com/dfns/dfns-sdk-ts/blob/m/examples/libs/viem/multicall/README.md

Execute the example with `ts-node main.ts`. The output shows the transaction hash of the batch transfer on Ethereum Holesky.

```shell
> ts-node main.ts

Transaction hash: 0xd9bfc96a8e14d35f35fff23bdb74e587f4ff977aad8806bdcfe69b118f03f49e
```

--------------------------------

### Run the multi-sig transaction example

Source: https://github.com/dfns/dfns-sdk-ts/blob/m/examples/libs/bitcoinjs/pay-to-multisig/README.md

Execute the main script to perform a 2-out-of-2 multi-sig transaction, transferring 1 satoshi between wallets.

```shell
> ts-node main.ts

Multisig address: tb1qpn9su2sej7n0hyel2rvkflkthzpm98gud34c4rx9mqt26623jm7s952y9r
Unspent balance: 8000 satoshis
Transfer amount: 1 satoshis
Transfer fee: 200 satoshis
Transaction hash: 9c3daf42bfcb7e4d2c824a67632b240439d298b97f8c7008632b9b3a40a7aa38
```

--------------------------------

### Run Polygon Deposit ERC20 Example

Source: https://github.com/dfns/dfns-sdk-ts/blob/m/examples/libs/ethersjs/v5/polygon-deposit-erc20/README.md

Execute the deposit example with ts-node. The output shows the USDC balance on Ethereum, the approval transaction hash, the L1 transaction hash, and the USDC balance after the deposit.

```shell
> ts-node main.ts

0x7c477E07b747a709F558e9e8B383b2a39e4d9708 USDC balance on Ethereum: 60000
Approve bridge contract allowance: 0xbe0de7da01e5bd4e2a7789012bf071e48b01c5df52ad65861dfba89ba2786ef4
Transaction hash on L1: 0x448df0058f1ea185b44a0c39a9d68894e151064ddcc7f99c52c9b359bd13b989
0x7c477E07b747a709F558e9e8B383b2a39e4d9708 USDC balance after Polygon deposit: 59900
```

--------------------------------

### Run Taproot example script

Source: https://github.com/dfns/dfns-sdk-ts/blob/m/examples/libs/bitcoinjs/taproot/README.md

Command to run the example script with ts-node. The script waits for a UTXO to be sent to the displayed address, then broadcasts the transaction and prints the resulting txid.

```shell
> ts-node main.ts

Running "Pay to Pubkey with taproot example"
Waiting till UTXO is detected at this Address: tb1ph97zustmss80y652k6gyc9j4ccghu2zeevp0yjs6eyaalty5xc8s5n595l
[
  {
    txid: '2cbd9ffe3cfecd8bdc81a1e83412aaafbfe4504076f5a7ae8bb5720e4cd9bf6f',
    vout: 0,
    status: { confirmed: false },
    value: 1000
  }
]
Using UTXO 2cbd9ffe3cfecd8bdc81a1e83412aaafbfe4504076f5a7ae8bb5720e4cd9bf6f:0
Broadcasting Transaction Hex: 020000000001016fbfd94c0e72b58baea7f5764050e4bfafaa1234e8a181dc8bcdfe3cfe9fbd2c0000000000ffffffff0152030000000000001976a91459cada50314c829e19f5a7786f8ee0d4987f429d88ac01406484b7433482629203796d99d80e83c33c1a6a2b4eb88c0b6ac1339785a1fb98154deb94ecb4c7dfed44ae0fa2a084f37a8ef259d8a05fecfb940ff9bf04561000000000
Success! Txid is 4bf436518bbb80e0611233271aa358c3617b225d86dd19d2cb3d6bd21e554f95
Running "Taptree example"
Waiting till UTXO is detected at this Address: tb1p8jrr24ss9kd2l3w7dqk7a606qz02jze4g6ezfmt8h4xc4fg09vasg6j42g
[
  {
    txid: 'd85061752ba6235ed04fdb17d96601120dcf5247aebeccc35a24494ea4a2713d',
    vout: 0,
    status: { confirmed: false },
    value: 1000
  }
]
Trying the Hash lock spend path with UTXO d85061752ba6235ed04fdb17d96601120dcf5247aebeccc35a24494ea4a2713d:0
Broadcasting Transaction Hex: 020000000001013d71a2a44e49245ac3ccbeae4752cf0d120166d917db4fd05e23a62b756150d80000000000ffffffff0152030000000000001976a91459cada50314c829e19f5a7786f8ee0d4987f429d88ac0440ac5a0a6ec76b3d5a8b80b79d4c55c7f91adf9d478e86a8aedfef6aa3511a5a7d0ae36d595146e637d2260b600a811f63f0b42116b5555dd1fe173e97ffc3d5260653454352455439a9142d261cc8cd214eccdfe4b0fa6a1d9576ae08a0c38820b54709bb7102c7645f18945eff6e2e1b9d7d72dc0eb33bbc90f3eb8617d24d35ac41c0e90ce2942b31e4b2ad5358006324512f87ff24ec94a2d0135365e29fb28d9f5895164eb266311b70c61f81dd4c46c95e1e0678b6312a2d8fa688bfe3a2810da400000000
Success! Txid is df1553aecb3e44dc905f61b1150e7a03852dbf8dcc3574fc72da5d740145c62b
Waiting till UTXO is detected at this Address: tb1p8jrr24ss9kd2l3w7dqk7a606qz02jze4g6ezfmt8h4xc4fg09vasg6j42g
[
  {
    txid: 'd85061752ba6235ed04fdb17d96601120dcf5247aebeccc35a24494ea4a2713d',
    vout: 0,
    status: { confirmed: false },
    value: 1000
  }
]
Trying the Hash lock spend path with UTXO d85061752ba6235ed04fdb17d96601120dcf5247aebeccc35a24494ea4a2713d:0
Broadcasting Transaction Hex: 020000000001013d71a2a44e49245ac3ccbeae4752cf0d120166d917db4fd05e23a62b756150d80000000000ffffffff0152030000000000001976a91459cada50314c829e19f5a7786f8ee0d4987f429d88ac01401036ffba310d39348b3faa33dec4af6024630da5d6a45ab67c7b88f43d115b195e7887230974d1f638b77e1a70d454d5d1e4c7589332cb158bf56b798dda652500000000
Success! Txid is df1553aecb3e44dc905f61b1150e7a03852dbf8dcc3574fc72da5d740145c62b
```

--------------------------------

### Initialize DfnsWallet with Taquito

Source: https://github.com/dfns/dfns-sdk-ts/blob/m/packages/lib-taquito/README.md

Setup routine for initializing the DfnsWallet, configuring the DfnsApiClient, and setting the signer provider for the TezosToolkit.

```typescript
import { DfnsWallet } from '@dfns/lib-tezos'
import { DfnsApiClient } from '@dfns/sdk'
import { AsymmetricKeySigner } from '@dfns/sdk-keysigner'
import { RpcClient} from '@taquito/rpc'

const signer = new AsymmetricKeySigner({
  privateKey: process.env.DFNS_PRIVATE_KEY!,
  credId: process.env.DFNS_CRED_ID!,
})

const dfnsClient = new DfnsApiClient({
  orgId: process.env.DFNS_ORG_ID!,
  authToken: process.env.DFNS_AUTH_TOKEN!,
  baseUrl: process.env.DFNS_API_URL!,
  signer,
})

const wallet = DfnsWallet.init({
  walletId: process.env.DFNS_WALLET_ID!,
  dfnsClient,
  maxRetries: 10,
})

// Replace with the RPC url/ chainId you want
const client = new RpcClient(
  'https://ghostnet.ecadinfra.com',
  'main',
) 

const Tezos = new TezosToolkit(client)
Tezos.setProvider({ signer: wallet })

// Now you can create/sign/broadcast operation
```

--------------------------------

### Setup DfnsWallet with xrpl.js

Source: https://github.com/dfns/dfns-sdk-ts/blob/m/packages/lib-xrpl/README.md

Initializes the Dfns API client with a signer, creates a DfnsWallet for a Ripple wallet, and connects to the XRP testnet. Requires environment variables for credentials and wallet ID.

```typescript
import { DfnsWallet } from '@dfns/lib-xrpl'
import { DfnsApiClient } from '@dfns/sdk'
import { AsymmetricKeySigner } from '@dfns/sdk-keysigner'
import { Client } from 'xrpl';

const signer = new AsymmetricKeySigner({
  privateKey: process.env.DFNS_PRIVATE_KEY!,
  credId: process.env.DFNS_CRED_ID!,
})

const dfnsClient = new DfnsApiClient({
  orgId: process.env.DFNS_ORG_ID!,
  authToken: process.env.DFNS_AUTH_TOKEN!,
  baseUrl: process.env.DFNS_API_URL!,
  signer,
})

const wallet = DfnsWallet.init({
    walletId: process.env.RIPPLE_WALLET_ID!,
    dfnsClient,
})

const client = new Client('wss://testnet.xrpl-labs.com')
```

--------------------------------

### Run Base Deposit Example

Source: https://github.com/dfns/dfns-sdk-ts/blob/m/examples/libs/ethersjs/v6/base-deposit-eth/README.md

Execute the deposit script using ts-node and view the transaction output.

```shell
> ts-node main.ts

Ethereum L1 sending address 0xD964D741998eDC275F3800eed113378a391951d9
Base L2 receiving address 0x416A2003ba6e8c2Ee25816A8cbd09DcA187049B3
Depositing 1 wei
Deposit L1 receipt is: 0x38434e48fd290247e0b5303966644db6e624eabc8c9c7670db9c45e77cc59c49
```

--------------------------------

### Run the Vechain transaction example

Source: https://github.com/dfns/dfns-sdk-ts/blob/m/examples/libs/vechain/basic-tx/README.md

Execute the main TypeScript file to run the example. The program converts 1 VET to VTHO on the Vechain testnet. The output shows the Vechain address, balances, transaction signer, and transaction ID.

```shell
> ts-node main.ts

Vechain address: 0x255101c3df61ca961206e4adf436c4f0cf5a9bde
Pre balance: 1000000000000000000000
Pre energy: 98783490000000000000
Transaction signer: 0x255101c3df61ca961206e4adf436c4f0cf5a9bde
Transaction txid: 0x93176b088de43647a4eb961ce8496e6ff76d459cea6940514015fd699ec87338
Post balance: 1000000000000000000000
Post energy: 98783590000000000000
```

--------------------------------

### Run Uniswap trading example with ts-node

Source: https://github.com/dfns/dfns-sdk-ts/blob/m/examples/libs/ethersjs/v6/uniswap/README.md

Execute the main.ts script to convert 1000000 wei of GoerliETH to Wrapped ETH and then swap for testnet USDC. The output shows transaction hashes for each step.

```shell
> ts-node main.ts

Convert ETH to WETH: 0x5d33e9e483ba632a64f69b05591df1245cee46c94ca1f4fb0b2d2a5185c19544
Approve Uniswap contract allowance: 0x4271f279b71284f6e6121c8355f733f00ddf008b9b8e67fe1f70ecbb18ae4743
Swapped WETH for USDC: 0xac8edab2abaf39826fa3c22086b749ec75f4bc54d78f1d7ff64f21214b0d8edf
```

--------------------------------

### Run the Osmosis transfer example

Source: https://github.com/dfns/dfns-sdk-ts/blob/m/examples/libs/cosmjs/basic-tx/README.md

Executes the main script with ts-node. The output shows the wallet address, chain ID, current balance, transaction hash, and balance after transfer.

```shell
> ts-node main.ts

Osmosis wallet address: osmo13fymmayt0rzr6ma0qd9hjmqtt3pk7xw7shqfkp
connected to chain id: osmo-test-5
current balance:  [ { denom: 'uosmo', amount: '5000000' } ]
transaction hash: 23C94526C8A9F12B781D901EEE8EC7E9184F0FF4514E5E39B4BDA09D7E3C5026
balance after transfer:  [ { denom: 'uosmo', amount: '4999249' } ]
```

--------------------------------

### Run the Tron resource delegation example

Source: https://github.com/dfns/dfns-sdk-ts/blob/m/examples/libs/tron/delegate-resource/README.md

Executes the main TypeScript file to delegate 1 TRX worth of resources (bandwidth and energy) from the delegator to the delegatee. The output shows the wallet addresses, max delegable SUN amounts, transaction IDs, and final staked amounts.

```shell
> ts-node main.ts

Tron delegator wallet address: TQJNezrbfJ3akrGgR7eM2fWyFpsKeM8wzN
Tron delegatee wallet address: TWnKPhJoyHPGWSRcTj9PAJABtnQ5qSipCq
Max delegable SUN for energy: 4998000000
Max delegable SUN for bandwidth: 2817763005
Delegating 1000000 SUN for bandwidth from TQJNezrbfJ3akrGgR7eM2fWyFpsKeM8wzN to TWnKPhJoyHPGWSRcTj9PAJABtnQ5qSipCq
Delegate bandwidth txID: 5e5653e18ac352b593a102d7c67675248c287125a93cccefc1713cd09a4c7143
Delegate bandwidth broadcasted: true
Delegating 1000000 SUN for energy from TQJNezrbfJ3akrGgR7eM2fWyFpsKeM8wzN to TWnKPhJoyHPGWSRcTj9PAJABtnQ5qSipCq
Delegate energy txID: 5dbc97026205268378f1033507a9a19513d938a80cd6314f1fbbdd15b8595781
Delegate energy broadcasted: true
waiting for transactions to finalize ...
Amount staked for bandwidth for TWnKPhJoyHPGWSRcTj9PAJABtnQ5qSipCq: 3000000
Amount staked for energy for TWnKPhJoyHPGWSRcTj9PAJABtnQ5qSipCq: 3000000
```

--------------------------------

### Run the gasless transaction example

Source: https://github.com/dfns/dfns-sdk-ts/blob/m/examples/libs/viem/biconomy-aa-gasless/README.md

Executes the main TypeScript file to create a smart contract account and send a gasless transaction. The output shows the smart account address, user operation hash, and transaction hash on Ethereum Sepolia.

```shell
> ts-node main.ts

Smart account address: 0x47cca03E330149dc23AFCFfd5F35695a2520d3fc
User operation hash: 0xa7e7ebeb2d0f12878034adef681f452f7e0226898d7671defe749f5fd79c6762
Transaction hash: 0x5a3ff714360dbded7fb9cdab0036186347caf37afed6ef36494a4d67324a3090
```

--------------------------------

### Run the TON transfer example

Source: https://github.com/dfns/dfns-sdk-ts/blob/m/examples/libs/ton/basic-tx/README.md

Execute the main TypeScript file with ts-node. The wallet must have TON to pay for fees. The output shows the wallet address, current balance, and balance after the transfer.

```shell
> ts-node main.ts

wallet address:  0QAXh03SUULqKi-6875HYA3SPJB5APqX8R0tGynQUEXKKmGg
current balance:  2000000000n
balance after transfer:  1994129596n
```

--------------------------------

### Run Tron staking example with ts-node

Source: https://github.com/dfns/dfns-sdk-ts/blob/m/examples/libs/tron/staking/README.md

Command to run the staking program. The output shows the wallet address, initial staked amounts (0), freeze transaction IDs and broadcast status, and final staked amounts (1000000) after waiting for transactions to finalize.

```shell
> ts-node main.ts

Tron wallet address: TQJNezrbfJ3akrGgR7eM2fWyFpsKeM8wzN
Amount staked for bandwidth: 0
Amount staked for energy: 0
Freeze bandwidth txID: 25e8e26fe492776f61ec1096d057cb20783773a11d9e2fdbfcb3075b8d18a2f1
Freeze bandwidth broadcasted: true
Freeze energy txID: 9a812a03b037c5f69098a9d8a9788d5eb307fb9e12ced1cc42d777ad99e44f86
Freeze energy broadcasted: true
waiting for transactions to finalize ...
Amount staked for bandwidth: 1000000
Amount staked for energy: 1000000
```

--------------------------------

### DfnsApiClient instantiation and wallet operations

Source: https://github.com/dfns/dfns-sdk-ts/blob/m/README.md

Creates a DfnsApiClient with a baseUrl, orgId, authToken, and a CredentialSigner. The authToken can be a service account token, a user PAT, or a user token. The example then creates a wallet on EthereumSepolia and fetches its assets.

```TypeScript
import { DfnsApiClient } from '@dfns/sdk'

const signer = ... // a Credential Signer (webauthN or key signer from section above)

const apiClient = new DfnsApiClient({
  baseUrl: 'https://api.dfns.io', // base Url of DFNS API
  orgId: 'or-2ng9jv-80cfc-983pop0iauf2sv8r', // ID of the Dfns Organisation
  authToken: '...', // an auth token
  signer,
})

// create a wallet
const wallet = await dfns.wallets.createWallet({
    body: { network: 'EthereumSepolia' }
})

// get assets in wallet
const { assets } = await dfns.wallets.getWalletAssets({ walletId: wallet.id })
```

--------------------------------

### Install iOS native dependencies

Source: https://github.com/dfns/dfns-sdk-ts/blob/m/examples/sdk/auth-delegated/README.md

Run pod install in the ios directory to install native iOS dependencies for the React Native app.

```bash
mobile/ios %  pod install

```

--------------------------------

### Initialize DfnsWallet for Aptos

Source: https://github.com/dfns/dfns-sdk-ts/blob/m/packages/lib-aptos/README.md

Sets up the DfnsWallet by creating an AsymmetricKeySigner, DfnsApiClient, and then initializing the wallet with a wallet ID. Requires environment variables for private key, credential ID, org ID, auth token, API URL, and wallet ID.

```typescript
import { DfnsWallet } from '@dfns/lib-aptos'
import { DfnsApiClient } from '@dfns/sdk'
import { AsymmetricKeySigner } from '@dfns/sdk-keysigner'

const signer = new AsymmetricKeySigner({
  privateKey: process.env.DFNS_PRIVATE_KEY!,
  credId: process.env.DFNS_CRED_ID!,
})

const dfnsClient = new DfnsApiClient({
  orgId: process.env.DFNS_ORG_ID!,
  authToken: process.env.DFNS_AUTH_TOKEN!,
  baseUrl: process.env.DFNS_API_URL!,
  signer,
})

const wallet = DfnsWallet.init({
  walletId: process.env.DFNS_WALLET_ID!,
  dfnsClient,
})
```

--------------------------------

### Start ngrok tunnel to express server

Source: https://github.com/dfns/dfns-sdk-ts/blob/m/examples/sdk/auth-delegated/README.md

Command to start an ngrok tunnel to the express.js server on localhost:8000, using a static domain name. Replace the domain with your own.

```bash
ngrok http --domain=panda-new-kit.ngrok-free.app http://localhost:8000
```

--------------------------------

### Initialize DfnsWallet with DfnsApiClient and AsymmetricKeySigner

Source: https://github.com/dfns/dfns-sdk-ts/blob/m/packages/lib-algorand/README.md

Sets up a DfnsWallet for Algorand by creating an AsymmetricKeySigner with your private key and credential ID, then initializing a DfnsApiClient with your organization ID, auth token, and API URL. Finally, it calls DfnsWallet.init with the wallet ID and client. Requires environment variables for all credentials.

```typescript
import { DfnsWallet } from '@dfns/lib-algorand'
import { DfnsApiClient } from '@dfns/sdk'
import { AsymmetricKeySigner } from '@dfns/sdk-keysigner'

const signer = new AsymmetricKeySigner({
  privateKey: process.env.DFNS_PRIVATE_KEY!,
  credId: process.env.DFNS_CRED_ID!,
})

const dfnsClient = new DfnsApiClient({
  orgId: process.env.DFNS_ORG_ID!,
  authToken: process.env.DFNS_AUTH_TOKEN!,
  baseUrl: process.env.DFNS_API_URL!,
  signer,
})

return DfnsWallet.init({
  walletId,
  dfnsClient,
})
```

--------------------------------

### Initialize DfnsWallet with ethers.js v6

Source: https://github.com/dfns/dfns-sdk-ts/blob/m/packages/lib-ethersjs6/README.md

Sets up a DfnsWallet by creating an RPC provider, an AsymmetricKeySigner, and a DfnsApiClient, then initializes the wallet and connects it to the provider. Requires environment variables for RPC URL, private key, credential ID, org ID, auth token, API URL, and wallet ID.

```typescript
import { DfnsWallet } from '@dfns/lib-ethersjs6'
import { DfnsApiClient } from '@dfns/sdk'
import { AsymmetricKeySigner } from '@dfns/sdk-keysigner'
import { JsonRpcProvider } from 'ethers'

const rpcProvider = new JsonRpcProvider(process.env.RPC_PROVIDER_URL!)

const signer = new AsymmetricKeySigner({
  privateKey: process.env.DFNS_PRIVATE_KEY!,
  credId: process.env.DFNS_CRED_ID!,
})

const dfnsClient = new DfnsApiClient({
  orgId: process.env.DFNS_ORG_ID!,
  authToken: process.env.DFNS_AUTH_TOKEN!,
  baseUrl: process.env.DFNS_API_URL!,
  signer,
})

return (
  await DfnsWallet.init({
    walletId: process.env.DFNS_WALLET_ID!,
    dfnsClient,
  })
).connect(rpcProvider)
```

--------------------------------

### Initialize DfnsWallet for Stellar

Source: https://github.com/dfns/dfns-sdk-ts/blob/m/packages/lib-stellar/README.md

Sets up a DfnsWallet for Stellar by creating an AsymmetricKeySigner and DfnsApiClient, then calling DfnsWallet.init with the wallet ID and client. Requires environment variables for private key, credential ID, org ID, auth token, and API URL.

```typescript
import { DfnsWallet } from '@dfns/lib-stellar'
import { DfnsApiClient } from '@dfns/sdk'
import { AsymmetricKeySigner } from '@dfns/sdk-keysigner'

const signer = new AsymmetricKeySigner({
  privateKey: process.env.DFNS_PRIVATE_KEY!,
  credId: process.env.DFNS_CRED_ID!,
})

const dfnsClient = new DfnsApiClient({
  orgId: process.env.DFNS_ORG_ID!,
  authToken: process.env.DFNS_AUTH_TOKEN!,
  baseUrl: process.env.DFNS_API_URL!,
  signer,
})

return DfnsWallet.init({
  walletId,
  dfnsClient,
})
```

--------------------------------

### Get end user wallets

Source: https://github.com/dfns/dfns-sdk-ts/blob/m/examples/sdk/nextjs-delegated-recovery/README.md

List all wallets for the end user.

```ts
const { items: wallets } = await dfnsDelegated.wallets.listWallets({})
```

--------------------------------

### Initialize DfnsWallet with DfnsApiClient and AsymmetricKeySigner

Source: https://github.com/dfns/dfns-sdk-ts/blob/m/packages/lib-iota/README.md

Sets up a DfnsWallet for Iota by creating an AsymmetricKeySigner with your private key and credential ID, then a DfnsApiClient with your organization ID, auth token, and API URL. Finally, initializes the wallet with a wallet ID and the client. Requires environment variables for credentials and API details.

```typescript
import { DfnsWallet } from '@dfns/lib-iota'
import { DfnsApiClient } from '@dfns/sdk'
import { AsymmetricKeySigner } from '@dfns/sdk-keysigner'

const signer = new AsymmetricKeySigner({
  privateKey: process.env.DFNS_PRIVATE_KEY!,
  credId: process.env.DFNS_CRED_ID!,
})

const dfnsClient = new DfnsApiClient({
  orgId: process.env.DFNS_ORG_ID!,
  authToken: process.env.DFNS_AUTH_TOKEN!,
  baseUrl: process.env.DFNS_API_URL!,
  signer,
})

return DfnsWallet.init({
  walletId,
  dfnsClient,
})
```

--------------------------------

### Delegated Login

Source: https://github.com/dfns/dfns-sdk-ts/blob/m/examples/sdk/nextjs-delegated-recovery/README.md

Call delegated login to get the end user auth token.

```ts
// call delegated login to get the user auth token
const { token: endUserAuthToken } = await dfns.auth.createDelegatedUserLogin({
  body: { username: body.email },
})
```

--------------------------------

### Run the Hedera transfer example

Source: https://github.com/dfns/dfns-sdk-ts/blob/m/examples/libs/hedera/basic-tx/README.md

Run the TypeScript program with ts-node. The program transfers 1 tℏ from a Dfns Hedera wallet to another account and prints the transaction ID.

```shell
> ts-node main.ts

Hedera wallet account ID: 0.0.6862141
transferring 1 tℏ from wallet 0.0.6862141 to 0x956fbb0c88b3c597d4afdbab3e26939051ff6725
creating transfer transaction...
signing and executing transfer transaction...
transaction executed. txId: 0.0.6862141@1758116522.512147680
```
Tokens:
Raw