Execute Transactions

This page describes how you can perform a transaction on chain

Introduction

It is not possible to execute a transaction from a wallet without the approval of the user. Therefore to be able to transfer a token, we will need to do two things: i) create the transfer and ii) ask the user for his approval.

The object that can ask the user his approval is called a Signer, once we've created a Signer object we can use the Signer to perform a transaction.

🚧

To perform actions on a wallet , such as transactions or signatures, the wallet has to be linked to your application. The easiest way to link a wallet to your application in to use getAccount flow. The benefits of using the getAccount flow is that this flow bundles multiple actions into one call.

Function:

//Asking the signer to transfer a certain value to a certain destination.
venlyConnect.signer.executeTransfer({
    walletId: '<WALLET_ID>',
    to: '<BLOCKCHAIN ADDRESS>',
    value: 3.1415,
    secretType: '<BLOCKCHAIN>',
    data: '0x<encoded_function>'
})

📘

Using the data attribute, you can pass in any encoded function call

Example:

Address

const venlyConnect = new VenlyConnect('YOUR_CLIENT_ID'); 

//Asking the signer to transfer to a blockchain address.
venlyConnect.signer.executeTransfer({
    walletId: 'c8ec9954-fa1a-4682-9cf8-ef5c1015d1d1',
    to: '0xf147cA0b981C0CD0955D1323DB9980F4B43e9FED',
    value: 0,
    secretType: 'ETHEREUM',
    data: '0x'
})

Email

const venlyConnect = new VenlyConnect('YOUR_CLIENT_ID'); 

//Asking the signer to transfer to an email address.
venlyConnect.signer.executeTransfer({
    walletId: '71dec640-4eb8-4321-adb8-b79461573fc4',
    to: '[email protected]',
    value: 0.01415,
    secretType: 'ETHEREUM',
})

📘

🧙 The destination of a transfer is not limited to a blockchain address, we also support email addresses and Unstoppable domains.

Returns:

{
    result: {
        transactionHash: "0xe18975940be795f178b2a0bc553a0d40e0ad6ceb72ee5f62ac53f0a816b4460f"
    }
    status: "SUCCESS"
}

JS Fiddle Example

Function Reference

The function reference describes the different functions that are available in the Widget. For each function, you can find the signature, it's parameters, and possible options documented.

📘