Create Proxy Wallet
In Vortex we created fully non-custodial architecture, where only you have access to assets. To achieve this we created deterministic scheme to create proxy wallets.
To generate wallets you can use Create Proxy Wallet on Curra API, and verify that this address belongs to your Ownership ID with Create Proxy Wallet, so assets from these wallets can be transferred only to your Ombibus wallets, whitelisted in Rules smart contract, ensuring security of your assets.
Every address is generated from unique salt (can be considered an unique identifier) and addresses remain the same across different EVM chains if their salts are equal. This means you can create the same addresses across multiple EVM blockchains.
How to calculate and verify address? (Advanced)
Addresses are fully deterministic and non-custodial. Gas Pump address is used as seed. After Ownership NFT is minted, addresses become immutable (this happens when first deposit is forwarded to Omnibus wallet) and only the NFT holder can change the Rule smart contract
Address calculation can defer on different platform / programming languages, but general algorithm is the following:
Calculate Ownership NFT identifier:
gasPumpAddress = "0x............"
presetsAddress = "0x............"
ownershipId = uint256(keccak256(abi.encodePacked(address(presetsAddress), keccak256(abi.encodepacked(gasPumpAddress)))))Calculate Rule upgradable proxy address:
// abi is predictProxyAddress(uint256), proxy address is upgradable proxy of the Rule smart contract
proxyAddress = curraContract.predictProxyAddress(ownershipId)Calculate forwarder implementation address which is going to be used to generate clones, aka proxy wallets
forwarderImplInitcode = "60a03461008b57601f61082c38819003918201601f19168301916001600160401b038311848410176100905780849260209460405283398101031261008b57516001600160a01b038116810361008b5760805260405161078590816100a7823960805181818160880152818160e801528181610172015281816101fc0152818161027d01526103c40152f35b600080fd5b634e487b7160e01b600052604160045260246000fdfe6080806040526004361015610022575b50361561001857005b61002061036b565b005b600090813560e01c90816325e3d522146102335750806358843b36146101ad5780637d76ccf114610117578063b41b08c2146100c15763d87108d00361000f57346100be57610070366102c9565b9073ffffffffffffffffffffffffffffffffffffffff7f00000000000000000000000000000000000000000000000000000000000000001633036100ba576100b79261062d565b80f35b8380fd5b80fd5b50346100be576100d0366102c9565b9073ffffffffffffffffffffffffffffffffffffffff7f00000000000000000000000000000000000000000000000000000000000000001633036100ba576100b792610554565b50346100be5760807ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc3601126100be5761014f6102a1565b60643573ffffffffffffffffffffffffffffffffffffffff80821682036100ba577f00000000000000000000000000000000000000000000000000000000000000001633036101a9576100b79160443590602435906106bc565b8280fd5b50346100be5760407ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc3601126100be576101e56102a1565b73ffffffffffffffffffffffffffffffffffffffff7f000000000000000000000000000000000000000000000000000000000000000016330361022f576100b7906024359061052e565b5080fd5b90503461022f57817ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc36011261022f5760209073ffffffffffffffffffffffffffffffffffffffff7f0000000000000000000000000000000000000000000000000000000000000000168152f35b6004359073ffffffffffffffffffffffffffffffffffffffff821682036102c457565b600080fd5b7ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc60609101126102c45773ffffffffffffffffffffffffffffffffffffffff60043581811681036102c457916024359160443590811681036102c45790565b67ffffffffffffffff811161033c57604052565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052604160045260246000fd5b604080517f8fab1a0600000000000000000000000000000000000000000000000000000000815230600482015247602482015260006044820181905273ffffffffffffffffffffffffffffffffffffffff9083836064817f000000000000000000000000000000000000000000000000000000000000000086165afa9283156104b45781948294610410575b50505082161561040c5761040a916104c0565b565b5050565b919450919250803d82116104ad575b7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0601f820116830183811067ffffffffffffffff8211176104805782528201829003126101a95780519282841684036100be575060200151903880806103f7565b6024867f4e487b710000000000000000000000000000000000000000000000000000000081526041600452fd5b503d61041f565b508351903d90823e3d90fd5b600080809381935af1156104d057565b60646040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601360248201527f4554485f5452414e534645525f4641494c4544000000000000000000000000006044820152fd5b9073ffffffffffffffffffffffffffffffffffffffff82161561040c5761040a916104c0565b91909173ffffffffffffffffffffffffffffffffffffffff80921680156106275760008093604493602096604051947fa9059cbb00000000000000000000000000000000000000000000000000000000865260048601526024850152165af13d15601f3d11600160005114161716156105c957565b60646040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152600f60248201527f5452414e534645525f4641494c454400000000000000000000000000000000006044820152fd5b50505050565b909173ffffffffffffffffffffffffffffffffffffffff809116918215610627571691823b156102c45760646000928360405195869485937f42842e0e000000000000000000000000000000000000000000000000000000008552306004860152602485015260448401525af180156106b0576106a75750565b61040a90610328565b6040513d6000823e3d90fd5b919273ffffffffffffffffffffffffffffffffffffffff8091169283156107485716803b156102c4576000928360c49260405196879586947ff242432a00000000000000000000000000000000000000000000000000000000865230600487015260248601526044850152606484015260a060848401528160a48401525af180156106b0576106a75750565b505050505056fea26469706673582212207adce9e6f6f4860d32d895a3080819821d79bea7e3699d0e3d8c4deb4aae60d064736f6c63430008120033"
const forwarderImplementationAddress = getCreate2Address(
ownershipNFTAddress, // deployer
ownershipId, // salt
forwarderImplInitcode, // initcode
);Calculate proxy wallet address:
salt = "0000000000000000" // 8 byes
forwarderImplAddressBytes = strip0x(forwarderImplementationAddress)
proxyInitcode = `0x602c3d8160093d39f33d3d3d3d363d3d37363d73${forwarderImplAddressBytes}5af43d3d93803e602a57fd5bf3`;
proxyInitcodeHash = keccak256(proxyInitcode);
forwarderAddress = getCreate2Address(
proxyAddress,
salt,
proxyInitcodeHash,
);forwarderAddress is the address of the proxy wallet.
Allocate address
POST https://api.curra.io/addresses
This method uses random salt to calculate next address.
Headers
content-type*
application/json
x-api-key*
your_api_key
Request Body
blockchains*
string[]
["ETHEREUM", "SMART_CHAIN", "POLYGON", "GOERLI"]
uniqueId
string
minLength: 1, maxLength: 100
meta
string
minLength: 1, maxLength: 500
You can find complete API Reference here.
SDK
Last updated