Quick Actions

DNA Quick Action

Generate deep links to the DNA app for quick actions like Swap and Send.

DNA now supports a Quick Action to deeplink directly into the wallet interface, allowing users to perform specific actions like sending tokens or swapping assets with predefined parameters.

Parameters

Name
tab
Type
string
Required
REQUIRED
Description
Supports deep linking to the swap and send tabs.
Name
fromToken
Type
string
Description
The contract address of the token being sent (fromToken).
Name
toToken
Type
string
Description
The contract address of the token being received (toToken). This is used in swap actions.
Name
recipientAddress or username
Type
string
Description
The recipient’s wallet address or username for sending tokens.
Name
amount
Type
string
Description
The amount of the fromToken to be sent, specified in its base unit .
Name
sourceAppId
Type
string
Description
The application ID of the source app initiating the deeplink.
Name
sourceDeeplinkPath
Type
string
Description
A deeplink path from the source application, which will be URL-encoded.

Helper Function

const DNA_APP_ID = 'app_8e407cfbae7ae51c19b07faff837aeeb'

function getDNADeeplinkUrl({
	tab,
	fromToken,
	toToken,
	recipientAddress,
	amount,
	sourceAppId,
	sourceDeeplinkPath,
}: {
	tab: 'swap' | 'send'
	fromToken?: string
	toToken?: string
	recipientAddress?: string
	amount?: string
	sourceAppId?: string
	sourceDeeplinkPath?: string
}) {
	let path = `/wallet?tab=${tab}`

	if (fromToken) {
		path += `&fromToken=${fromToken}`
		if (amount) {
			path += `&amount=${amount}`
		}
	}

	if (toToken) {
		path += `&toToken=${toToken}`
	}

	if (recipientAddress) {
		path += `&recipientAddress=${recipientAddress}`
	}

	if (sourceAppId) {
		path += `&sourceAppId=${sourceAppId}`
	}

	if (sourceDeeplinkPath) {
		path += `&sourceDeeplinkPath=${encodeURIComponent(sourceDeeplinkPath)}`
	}

	const encodedPath = encodeURIComponent(path)
	return `https://worldcoin.org/mini-app?app_id=${DNA_APP_ID}&path=${encodedPath}`
}

Returns

A string representing the complete deeplink URL to the DNA application with the specified parameters.

Example Usage

const deeplinkUrl = getDNADeeplinkUrl({
  fromToken: '0x79A02482A880bCE3F13e09Da970dC34db4CD24d1',
  toToken: '0x4200000000000000000000000000000000000006',
  recipientAddress: '0xRecipientAddressHere',
  amount: ‘1235',
  sourceAppId: 'app_a4f7f3e62c1de0b9490a5260cb390b56',
  sourceDeeplinkPath: ‘/path’,
});
console.log(deeplinkUrl);

Generated Deeplink URL:

https://worldcoin.org/mini-app?app_id=app_8e407cfbae7ae51c19b07faff837aeeb&path=%2Fwallet%3Ftab%3Dsend%26fromToken%3D0x79A02482A880bCE3F13e09Da970dC34db4CD24d1%26amount%3D1234500%26toToken%3D0x4200000000000000000000000000000000000006%26recipientAddress%3D0xRecipientAddressHere%26sourceAppId%3Dapp_a4f7f3e62c1de0b9490a5260cb390b56%26sourceDeeplinkPath%3D%252Fsome%252Fpath

Note

Ensure that the amount is specified in the unit of the fromToken (e.g., wei for Ethereum-based tokens).
The sourceDeeplinkPath is URL-encoded to ensure it is correctly interpreted when the deeplink is accessed.
The DNA_APP_ID should be defined in your environment to match the application ID assigned to your DNA instance.
If the tab is Send, it is necessary/recommended to provide fromToken, amount, and the recipient’s address or username (toToken is not required).
If the tab is Swap, it is necessary/recommended to provide fromToken, toToken, and amount (in base unit).

This function facilitates the creation of deeplink URLs that can be used to direct users seamlessly into specific actions within the DNA application, enhancing the user experience by pre-filling transaction details.