Funding an Escrow
Before sending any funds to an escrow ensure that the client address can call the proper functions to release
and lock
The Raid party lead is responsible for working with the client to help them make their deposit into the escrow. The following deposit instructions can be shared to ensure that the client is able to make their deposit successfully.
Paying with an Externally Owned Account (e.g. MetaMask, Rainbow)
If you are funding an escrow from an EOA like MetaMask, follow these instructions:
- Go to
https://dm.raidguild.org/escrow/[RaidID]
(Cleric note: replace [RaidID] with the Raid ID from Dungeon Master) - Connect your MetaMask or WalletConnect wallet
- Follow the instructions to deposit, there will be 2 transactions
- the first transaction is to approve the Raid Guid Escrow contract to transfer your tokens
- the second on is to actually transfer the tokens to the escrow contract
- Refresh to verify that the deposit has been made (you may need to reconnect your wallet).
The Escrow is also accessible directly in SmartInvoice, so once you get the escrow address, you can provide the SmartInvoice link which may be more client friendly. A handy link to SmartInvoice is provided on the Raid's escrow page.
Only whitelisted tokens will be accessible as escrow tokens! Only send tokens to an escrow you're sure are whitelisted. Additional tokens cannot be whitelisted after creation.
[Legacy] Gnosis Safe instructions
Connecting via WalletConnect or the Safe Apps should allow you to follow the same process as above for EOAs.
If you are paying Raid Guild from a Gnosis Safe, follow the below instructions to generate the correct transaction from the Gnosis Safe itself. Alternatively, you can use the WalletConnect app in the Gnosis Safe to interact with the Raid Guild Escrow app directly (e.g., as if you were using Metamask).
Using the transaction builder used to be necessary. Now you should be able to use WalletConnect or connect to a safe via Safe Apps so this should* no longer be needed.
Step 1: Approve the escrow contract to transfer the token
If you are raiding on Optimism, you are only able to pay with native USDC (0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85
).
- Go to your Gnosis Safe interface
- Click New Transaction
- Click Contract Interaction
- In the Recipient field, paste the address of the token you're paying with
- wxDAI:
0xe91D153E0b41518A2Ce8Dd3D7944Fa863463a97d
- WETH:
0x36c06Cb8EE68D632bDEfeb969b4751F73c67d891
- wxDAI:
- The ABI field will auto-populate and a dropdown menu will appear underneath
- From the dropdown menu, select the Approve function. Two new fields will appear underneath
- In the first field (
usr
for DAI orguy
for WETH), paste the address of the Raid Guild Escrow contract on Gnosis - In the second field (
wad
), enter the amount of tokens to deposit, multiplied by 10^18.- If your payment does not have any decimals (e.g. 10 DAI, not 10.5 DAI), then multiplying by 10^18 is equivalent to adding 18 zeroes to the end.
- You can copy/paste 18 zeroes from here:
000000000000000000
- Click Review
- Check that everything matches the correct inputs, and then click Submit
- Process the transaction as you would any other Gnosis Safe transaction
Step 2: Transfer or deposit tokens into the escrow
- Click New Transaction again
- Click Contract Interaction
- In the Recipient field, paste the address of the Raid Guild Escrow contract
- The ABI field will auto-populate and a dropdown menu will appear underneath
- From the dropdown menu, select the
deposit
function. Two new fields will appear underneath - In the first field (
token
), enter the payment token address. - In the second field (
amount
), enter the amount in wei- If your payment does not have any decimals (e.g. 10 DAI, not 10.5 DAI), then multiplying by 10^18 is equivalent to adding 18 zeroes to the end.
- You can copy/paste 18 zeroes from here:
000000000000000000
- Click Review
- Check that everything matches the correct inputs, and then click Submit
- Process the transaction as you would any other Gnosis Safe transaction
Finally, check with RaidGuild to confirm that the deposit was successful.