2f:["$","$L31",null,{"children":["$","$L32",null,{"children":["$","div",null,{"className":"flex min-h-screen flex-col justify-between","children":[["$","$L33",null,{"enableScrollIndicator":"$undefined","title":"Interactive Quickstarts"}],[["$","$L34",null,{"contentWrapperId":"$35","items":[{"__typename":"NavigationItem","label":"Overview","icon":null,"url":"/interactive-quickstarts","fallbackUrl":null,"isHidden":null,"children":null},{"__typename":"NavigationItem","label":"Get Started","icon":null,"url":"/interactive-quickstarts/get-started","fallbackUrl":null,"isHidden":null,"children":null},{"__typename":"NavigationItem","label":"Developer Controlled Wallets","icon":null,"url":"/interactive-quickstarts/dev-controlled-wallets","fallbackUrl":null,"isHidden":null,"children":[{"__typename":"NavigationItem","label":"Introduction","url":"/interactive-quickstarts/dev-controlled-wallets#introduction","fallbackUrl":null,"isHidden":null},{"__typename":"NavigationItem","label":"Prerequisites","url":"/interactive-quickstarts/dev-controlled-wallets#prerequisites","fallbackUrl":null,"isHidden":null},{"__typename":"NavigationItem","label":"Setup your Entity Secret","url":"/interactive-quickstarts/dev-controlled-wallets#setup-your-entity-secret","fallbackUrl":null,"isHidden":null},{"__typename":"NavigationItem","label":"Create a Wallet","url":"/interactive-quickstarts/dev-controlled-wallets#create-a-wallet","fallbackUrl":null,"isHidden":null},{"__typename":"NavigationItem","label":"Initiate a Transaction","url":"/interactive-quickstarts/dev-controlled-wallets#initiate-a-transaction","fallbackUrl":null,"isHidden":null},{"__typename":"NavigationItem","label":"Congratulations on your Progress!","url":"/interactive-quickstarts/dev-controlled-wallets#congratulations-on-your-progress","fallbackUrl":null,"isHidden":null}]},{"__typename":"NavigationItem","label":"User Controlled Wallets","icon":null,"url":"/interactive-quickstarts/user-controlled-wallets","fallbackUrl":null,"isHidden":null,"children":null},{"__typename":"NavigationItem","label":"Cross Chain Transfer Protocol","icon":null,"url":"/interactive-quickstarts/cctp","fallbackUrl":null,"isHidden":null,"children":null}],"parent":{"__typename":"NavigationItem","label":"All Docs","url":"/"},"path":[{"__typename":"NavigationItem","label":"All Docs","icon":null,"url":"/","fallbackUrl":null,"isHidden":null,"children":null},{"__typename":"NavigationItem","label":"Interactive Quickstarts","icon":null,"url":"","fallbackUrl":null,"isHidden":null,"children":null},{"__typename":"NavigationItem","label":"Developer Controlled Wallets","icon":null,"url":"/interactive-quickstarts/dev-controlled-wallets","fallbackUrl":null,"isHidden":null,"children":null}],"title":"Interactive Quickstarts"}],["$","$L36",null,{"contentWrapperId":"$35","items":"$37","parent":"$44","path":"$45","title":"Interactive Quickstarts"}]],["$","div",null,{"className":"flex flex-col overflow-hidden md:overflow-visible pt-0 pt-header px-6 mt-8","id":"$35","children":["$","div",null,{"className":"flex flex-col flex-1 pb-7 overflow-hidden","children":[["$","$L49",null,{"initiator":"Dev-Controlled"}],["$","div",null,{"className":"md:pl-sidebar max-w-main-max md:mx-auto w-full","children":[["$","div",null,{"className":"flex pb-2 pt-1 items-start gap-2","children":"$L4a"}],["$","$L4b",null,{"className":"pb-7","variant":"page/sm","children":[["$","$L4c",null,{"as":"h1","children":"Developer Controlled Wallets"}],["$","$L4d",null,{"children":"$undefined"}]]}],["$","div",null,{"className":"w-full flex gap-16","children":["$","div",null,{"className":"w-full space-y-4","children":[["$","div",null,{"className":"w-full py-6 border-b border-neutral-subtle space-y-4 first:pt-0 last:pb-0 last:border-0","children":[["$","h2",null,{"className":"text-neutral font-circular-medium text-2xl first:pt-0 pt-2","id":"introduction","children":"Introduction"}],[["$","p",null,{"className":"text-base","children":"Welcome to the dynamic world of Web3. Whether you're a seasoned blockchain enthusiast or stepping into the decentralized sphere for the first time, this guide tailored for Developer-Controlled Wallets using Circle's Web3 Services Console awaits."}],["$","p",null,{"className":"text-base","children":"Harness the power of Web3 technology to provide an unparalleled experience for your users, while maintaining full control and enhanced security over their wallets. Let's take a peek at the standout features that make the Web3 Services Console an irresistible choice for your application"}],["$","div",null,{"className":"w-full py-2","children":["$","div",null,{"className":"border border-neutral-subtle p-6 grid grid-cols-1 rounded-lg gap-6 bg-primary lg:grid-cols-2 bg-primary","data-testid":"features-background","children":[["$","div",null,{"className":"flex items-start justify-start","children":[["$","$L4e",null,{"className":"mr-2 mt-1 h-5 w-5 shrink-0 text-blue-600","name":"LockClosedSolid"}],["$","div",null,{"children":[["$","p",null,{"className":"text-base","children":["$","strong",null,{"className":"-mt-px mb-1 flex items-center text-base text-neutral-strong font-circular-bold","children":["Advanced Security",null]}]}],["$","div",null,{"className":"text-sm text-neutral font-circular-regular","children":["$","p",null,{"className":"text-base","children":"Benefit from MPC technology, which eliminates single points of failure and\nenhances security against unauthorized access and theft."}]}]]}]]}],["$","div",null,{"className":"flex items-start justify-start","children":[["$","$L4e",null,{"className":"mr-2 mt-1 h-5 w-5 shrink-0 text-blue-600","name":"SparklesOutline"}],["$","div",null,{"children":[["$","strong",null,{"className":"-mt-px mb-1 flex items-center text-base text-neutral-strong font-circular-bold","children":[["$","p",null,{"className":"text-base","children":"Innovative Blockchain Functionality"}],null]}],["$","div",null,{"className":"text-sm text-neutral font-circular-regular","children":["$","p",null,{"className":"text-base","children":"Grant users access to digital currencies, NFTs, and other\nblockchain-powered experiences with ease."}]}]]}]]}],["$","div",null,{"className":"flex items-start justify-start","children":[["$","$L4e",null,{"className":"mr-2 mt-1 h-5 w-5 shrink-0 text-blue-600","name":"ArrowsExpandOutline"}],["$","div",null,{"children":[["$","p",null,{"className":"text-base","children":["$","strong",null,{"className":"-mt-px mb-1 flex items-center text-base text-neutral-strong font-circular-bold","children":["Blockchain Agnostic",null]}]}],["$","div",null,{"className":"text-sm text-neutral font-circular-regular","children":["$","p",null,{"className":"text-base","children":"Build once, deploy across multiple blockchains, such as Ethereum, Polygon,\nand Avalanche."}]}]]}]]}],["$","div",null,{"className":"flex items-start justify-start","children":[["$","$L4e",null,{"className":"mr-2 mt-1 h-5 w-5 shrink-0 text-blue-600","name":"ShieldExclamationOutline"}],["$","div",null,{"children":[["$","strong",null,{"className":"-mt-px mb-1 flex items-center text-base text-neutral-strong font-circular-bold","children":[["$","p",null,{"className":"text-base","children":"Reliable Operations Monitoring"}],null]}],["$","div",null,{"className":"text-sm text-neutral font-circular-regular","children":["$","p",null,{"className":"text-base","children":"Built-in transaction logs, user-level monitoring, and error reporting help\nyou troubleshoot and support your users effectively."}]}]]}]]}],["$","div",null,{"className":"flex items-start justify-start","children":[["$","$L4e",null,{"className":"mr-2 mt-1 h-5 w-5 shrink-0 text-blue-600","name":"LightningBoltOutline"}],["$","div",null,{"children":[["$","p",null,{"className":"text-base","children":["$","strong",null,{"className":"-mt-px mb-1 flex items-center text-base text-neutral-strong font-circular-bold","children":["Instant Access",null]}]}],["$","div",null,{"className":"text-sm text-neutral font-circular-regular","children":["$","p",null,{"className":"text-base","children":"Get started immediately, with pay-as-you-go pricing and no upfront fees or\ncontracts."}]}]]}]]}]]}]}]]]}],"\n",["$","div",null,{"className":"w-full py-6 border-b border-neutral-subtle space-y-4 first:pt-0 last:pb-0 last:border-0","children":[["$","h2",null,{"className":"text-neutral font-circular-medium text-2xl first:pt-0 pt-2","id":"prerequisites","children":"Prerequisites"}],["$","p",null,{"className":"text-base","children":"Before you get started, ensure that you have:"}],["$","ul",null,{"className":"ml-4 list-outside list-disc pb-2 marker:text-black marker:text-left [&>li]:pl-2","children":["\n",["$","li",null,{"children":["Have a ",["$","a",null,{"className":"text-interactive font-circular-medium hover:text-blue-400","target":"_self","href":"/get-started#create-a-web3-services-account","children":"Web3 Services account"}]]}],"\n",["$","li",null,{"children":["Created your ",["$","a",null,{"className":"text-interactive font-circular-medium hover:text-blue-400","target":"_self","href":"/get-started#create-your-api-key","children":"API key"}]]}],"\n",["$","li",null,{"children":["(Optional) Install ",["$","a",null,{"className":"text-interactive font-circular-medium hover:text-blue-400","target":"_self","href":"/w3s/server-side-sdks","children":"Server-side SDK"}]," (required if you register Entity Secret via SDK)"]}],"\n"]}],["$","$L4f",null,{"children":[["$","$L50",null,{"language":"shell","code":"// Developer Controlled Wallets\nnpm install @circle-fin/developer-controlled-wallets --save\n// User Controlled Wallets\nnpm install @circle-fin/user-controlled-wallets --save\n// Smart Contract Platform\nnpm install @circle-fin/smart-contract-platform --save\n","title":"Node.js","children":["$","code",null,{"className":"bg-code text-sm p-1 rounded-sm language-shell","children":"// Developer Controlled Wallets\nnpm install @circle-fin/developer-controlled-wallets --save\n// User Controlled Wallets\nnpm install @circle-fin/user-controlled-wallets --save\n// Smart Contract Platform\nnpm install @circle-fin/smart-contract-platform --save\n"}]}],["$","$L50",null,{"language":"shell","code":"#Developer Controlled Wallets\npip install --upgrade circle-developer-controlled-wallets\n#User Controlled Wallets\npip install --upgrade circle-user-controlled-wallets\n#Smart Contract Platform\npip install --upgrade circle-smart-contract-platform\n","title":"Python","children":["$","code",null,{"className":"bg-code text-sm p-1 rounded-sm language-shell","children":"#Developer Controlled Wallets\npip install --upgrade circle-developer-controlled-wallets\n#User Controlled Wallets\npip install --upgrade circle-user-controlled-wallets\n#Smart Contract Platform\npip install --upgrade circle-smart-contract-platform\n"}]}]]}]]}],"\n",["$","div",null,{"className":"w-full py-6 border-b border-neutral-subtle space-y-4 first:pt-0 last:pb-0 last:border-0","children":[["$","h2",null,{"className":"text-neutral font-circular-medium text-2xl first:pt-0 pt-2","id":"setup-your-entity-secret","children":"Setup your Entity Secret"}],[["$","p",null,{"className":"text-base","children":"The Entity Secret is an integral component in Developer-Controlled Wallets, serving as a key element in bolstering security."}],["$","h3",null,{"className":"text-neutral-strong font-circular-regular text-xl py-4","id":"what-is-the-entity-secret","children":"What is the Entity Secret?"}],["$","p",null,{"className":"text-base","children":"The Entity Secret is a robust 32-byte key engineered to enhance the security mechanisms of Developer Controlled Wallets. Its value lies not only in its complexity but also in the specific security benefits it confers."}],["$","h3",null,{"className":"text-neutral-strong font-circular-regular text-xl py-4","id":"the-importance-of-the-entity-secret","children":"The importance of the Entity Secret"}],["$","div",null,{"className":"w-full py-2","children":["$","div",null,{"className":"border border-neutral-subtle p-6 grid grid-cols-1 rounded-lg gap-6 bg-white","data-testid":"features-background","children":[["$","div",null,{"className":"flex items-start justify-start","children":[["$","$L4e",null,{"className":"mr-2 mt-1 h-5 w-5 shrink-0 text-blue-600","name":"LockClosedSolid"}],["$","div",null,{"children":[["$","p",null,{"className":"text-base","children":["$","strong",null,{"className":"-mt-px mb-1 flex items-center text-base text-neutral-strong font-circular-bold","children":["Exclusivity",null]}]}],["$","div",null,{"className":"text-sm text-neutral font-circular-regular","children":["$","p",null,{"className":"text-base","children":"The Entity Secret is generated by you and remains known exclusively to\nyou. Consider it as your private password or a cryptographic signature\nthat distinguishes your activities."}]}]]}]]}],["$","div",null,{"className":"flex items-start justify-start","children":[["$","$L4e",null,{"className":"mr-2 mt-1 h-5 w-5 shrink-0 text-blue-600","name":"ShieldCheckOutline"}],["$","div",null,{"children":[["$","strong",null,{"className":"-mt-px mb-1 flex items-center text-base text-neutral-strong font-circular-bold","children":[["$","p",null,{"className":"text-base","children":"Enhanced Security for Critical API Requests"}],null]}],["$","div",null,{"className":"text-sm text-neutral font-circular-regular","children":["$","p",null,{"className":"text-base","children":"For critical actions such as wallet creation or initiating transactions,\nthe Entity Secret comes into play. Attaching an encrypted version of the\nEntity Secret to these API requests provides an added authentication\nfactor, reinforcing the security infrastructure."}]}]]}]]}],["$","div",null,{"className":"flex items-start justify-start","children":[["$","$L4e",null,{"className":"mr-2 mt-1 h-5 w-5 shrink-0 text-blue-600","name":"KeyOutline"}],["$","div",null,{"children":[["$","p",null,{"className":"text-base","children":["$","strong",null,{"className":"-mt-px mb-1 flex items-center text-base text-neutral-strong font-circular-bold","children":["Dynamic Protection",null]}]}],["$","div",null,{"className":"text-sm text-neutral font-circular-regular","children":["$","p",null,{"className":"text-base","children":"With a requirement to re-encrypt the Entity Secret for each API request,\nyou avoid the risks associated with having a static key, which could be\nvulnerable to security breaches. This dynamic approach means that every\nrequest is identifiably distinct, providing fortified protection against\npotential attacks."}]}]]}]]}],["$","div",null,{"className":"flex items-start justify-start","children":[["$","$L4e",null,{"className":"mr-2 mt-1 h-5 w-5 shrink-0 text-blue-600","name":"UserOutline"}],["$","div",null,{"children":[["$","p",null,{"className":"text-base","children":["$","strong",null,{"className":"-mt-px mb-1 flex items-center text-base text-neutral-strong font-circular-bold","children":["Sole Authority",null]}]}],["$","div",null,{"className":"text-sm text-neutral font-circular-regular","children":["$","p",null,{"className":"text-base","children":"While our platform enables operations using the Entity Secret, it does not\nstore it. This design choice comes with dual implications: First, it\nensures you are the sole entity capable of using your private keys, thus\npreserving absolute control over them. Second, it places the\nresponsibility squarely on your shoulders to secure the Entity Secret\nconscientiously, as its security is paramount to the overall protection of\nyour Developer-Controlled Wallets."}]}]]}]]}]]}]}],["$","h3",null,{"className":"text-neutral-strong font-circular-regular text-xl py-4","id":"balancing-power-with-responsibility-as-a-developer","children":"Balancing Power with Responsibility as a Developer"}],["$","p",null,{"className":"text-base","children":"The Entity Secret embodies the level of trust and authority that our platform confers upon developers. It enables smooth access to the extensive capabilities of developer-controlled wallets, while simultaneously ensuring their security is maintained. However, great power necessitates equally great responsibility. The safeguarding, encryption, and periodic renewal of the Entity Secret are duties that rest with you, the developer."}],["$","p",null,{"className":"text-base","children":"This dynamic of empowering developers while also entrusting them with critical security tasks reflects the core principles of decentralization intrinsic to the web3 ecosystem. As a developer, you're more than a creator; you assume the role of a guardian of security and a proponent of distributed authority."}],["$","$L51",null,{"variant":"info","children":["$","p",null,{"className":"text-base","children":"Should you sense the weight of this role, rest assured that guidance is at hand. We are here to support you in effectively managing and protecting your Entity Secret."}]}],["$","h3",null,{"className":"text-neutral-strong font-circular-regular text-xl py-4","id":"generating-the-entity-secret","children":"Generating the Entity Secret"}],["$","$L4f",null,{"children":[["$","$L50",null,{"language":"javascript","code":"import { generateEntitySecret } from '@circle-fin/developer-controlled-wallets'\n// This will print a new entity secret in the terminal\ngenerateEntitySecret()\n","title":"NodeJS SDK","children":["$","code",null,{"className":"bg-code text-sm p-1 rounded-sm language-javascript","children":"import { generateEntitySecret } from '@circle-fin/developer-controlled-wallets'\n// This will print a new entity secret in the terminal\ngenerateEntitySecret()\n"}]}],["$","$L50",null,{"language":"python","code":"from circle.web3 import utils\n# This will print a new entity secret in the terminal\nutils.generate_entity_secret()\n","title":"Python SDK","children":["$","code",null,{"className":"bg-code text-sm p-1 rounded-sm language-python","children":"from circle.web3 import utils\n# This will print a new entity secret in the terminal\nutils.generate_entity_secret()\n"}]}],["$","$L50",null,{"language":"node","code":"import crypto from \"crypto\";\n\nconst secret = crypto.randomBytes(32).toString('hex')\n\nconsole.log(secret)\n"}],["$","$L50",null,{"language":"js","code":"let array = new Uint8Array(32)\nwindow.crypto.getRandomValues(array)\nlet secret = Array.from(array)\n.map((b) => b.toString(16).padStart(2, '0'))\n.join('')\n\nconsole.log(secret) "}],["$","$L50",null,{"language":"bash","code":"openssl rand -hex 32"}],["$","$L50",null,{"language":"python","code":"import os\n\nsecret = os.urandom(32).hex()\n\nprint(secret) "}],["$","$L50",null,{"language":"go","code":"package main\n\nimport (\n\"crypto/rand\"\n\"fmt\"\n\"io\"\n)\n\nfunc generateRandomHex() []byte { \nmainBuff := make([]byte, 32) \n_, err := io.ReadFull(rand.Reader, mainBuff) \nif err != nil { \n panic(\"reading from crypto/rand failed: \" + err.Error())\n}\nreturn mainBuff\n}\n\n// The following sample codes generate a distinct hex encoded entity secret with each execution\n// The generation of entity secret only need to be executed once unless you need to rotate entity secret.\nfunc main() { \nentitySecret := generateRandomHex()\nfmt.Printf(\"Hex encoded entity secret: %x\n\", entitySecret)\n}"}]]}],["$","$L52",null,{"title":"Generate your own Entity Secret","url":"/quickstarts/api/common/entity-secret"}],["$","$L51",null,{"variant":"warning","children":["$","p",null,{"className":"text-base","children":"It's crucial to safeguard your Entity Secret akin to a key to your home—misplacing it or divulging it to others could have serious ramifications. Ensure you securely store the Entity Secret because you'll require it shortly to create an Entity Secret Ciphertext. Just as the name implies, the Entity Secret is sensitive information; treat it with the utmost confidentiality and security to prevent unauthorized access or use."}]}],["$","p",null,{"className":"text-base","children":"With your Entity Secret now created, we're ready to advance to a critical juncture. You're about to convert the Entity Secret into Ciphertext and register it with the system. This process sets the stage for you to create your first wallet—a milestone to look forward to."}],["$","h3",null,{"className":"text-neutral-strong font-circular-regular text-xl py-4","id":"retrieving-your-entitys-public-key-optional-if-registering-with-sdk","children":"Retrieving Your Entity's Public Key (Optional if registering with SDK)"}],["$","p",null,{"className":"text-base","children":"Begin by acquiring your entity's public key. This key is retrievable via our APIs and is instrumental in the upcoming steps. To obtain it, use your API key for authentication. The entity's public key plays a crucial role as it encrypts your Entity Secret. Once encrypted, the Entity Secret remains secure, ensuring the information is shared exclusively between you and the platform, keeping it out of reach from outsiders."}],["$","$L52",null,{"title":"Fetching your public key","url":"/quickstarts/api/common/public-key","config":{"method":"GET","url":"/v1/w3s/config/entity/publicKey","headers":{"Content-Type":"application/json","Authorization":"Bearer "}}}],["$","h3",null,{"className":"text-neutral-strong font-circular-regular text-xl py-4","id":"encrypting-the-entity-secret-and-encoding-in-base64-optional-if-registering-with-sdk","children":"Encrypting the Entity Secret and Encoding in Base64 (Optional if registering with SDK)"}],["$","p",null,{"className":"text-base","children":"After obtaining the public key, the next step involves using RSA encryption to secure your Entity Secret. Follow these steps:"}],["$","ol",null,{"children":[["$","li",null,{"children":[["$","div",null,{"className":"flex items-start justify-start gap-x-4","children":[["$","div",null,{"className":"flex h-8 w-8 items-center justify-center rounded-full border border-black-200 p-2 text-neutral-subtle","data-testid":"step-index-1","children":1}],["$","h4",null,{"className":"text-xl text-neutral-strong font-circular-medium","children":"Encrypt the Entity Secret"}]]}],["$","div",null,{"className":"my-2 ml-4 pl-8 space-y-4 pb-4 [&>*]:pb-0 border-l border-black-50","data-testid":"step-separator-1","children":["$","p",null,{"className":"text-base","children":"Employ RSA encryption with the public key to encrypt your Entity Secret.\nThis cryptographic process ensures that the secret is encoded in such a way\nthat only someone with the private key can decrypt it."}]}]]}],["$","li",null,{"children":[["$","div",null,{"className":"flex items-start justify-start gap-x-4","children":[["$","div",null,{"className":"flex h-8 w-8 items-center justify-center rounded-full border border-black-200 p-2 text-neutral-subtle","data-testid":"step-index-2","children":2}],["$","h4",null,{"className":"text-xl text-neutral-strong font-circular-medium","children":"Encode as Base64"}]]}],["$","div",null,{"className":"my-2 ml-4 pl-8 space-y-4 pb-4 [&>*]:pb-0 border-l border-black-50","data-testid":"step-separator-2","children":["$","p",null,{"className":"text-base","children":"After encryption, convert the encrypted data into Base64 format. Encoding in\nBase64 ensures the encrypted data can be safely conveyed and interpreted in\nvarious contexts, including those that may not handle binary data well."}]}]]}],["$","li",null,{"children":[["$","div",null,{"className":"flex items-start justify-start gap-x-4","children":[["$","div",null,{"className":"flex h-8 w-8 items-center justify-center rounded-full border border-black-200 p-2 text-neutral-subtle","data-testid":"step-index-3","children":3}],["$","h4",null,{"className":"text-xl text-neutral-strong font-circular-medium","children":"Verify the Ciphertext Length"}]]}],["$","div",null,{"className":"my-2 ml-4 pl-8 space-y-4 pb-4 [&>*]:pb-0","data-testid":"step-separator-3","children":["$","p",null,{"className":"text-base","children":"Ensure that the generated Ciphertext is 684 characters in length. This\nspecific length confirms the encryption process has been executed properly\nand that the data will be maintained correctly upon receipt."}]}]]}]]}],["$","p",null,{"className":"text-base","children":"The code provided will assist in automating this encryption process, generating a unique Entity Secret Ciphertext every time it is executed. The resulting Ciphertext is what you'll use to interact securely with the platform's API when performing operations that require it."}],["$","$L4f",null,{"title":"Encrypt your Entity Secret","children":[["$","$L50",null,{"language":"node","code":"// npm install node-forge -S\n\nimport forge from \"node-forge\";\n\nconst entitySecret = forge.util.hexToBytes('YOUR_ENTITY_SECRET');\n\nconst publicKey = forge.pki.publicKeyFromPem('YOUR_PUBLIC_KEY');\n\nconst encryptedData = publicKey.encrypt(entitySecret, 'RSA-OAEP', { md: forge.md.sha256.create(), mgf1: { md: forge.md.sha256.create(), }, });\n\nconsole.log(forge.util.encode64(encryptedData)) "}],["$","$L50",null,{"language":"python","code":"$53"}],["$","$L50",null,{"language":"go","code":"$54"}]]}],["$","$L52",null,{"title":"Generate Entity Secret Ciphertext","url":"/quickstarts/api/common/entity-secret-ciphertext"}],["$","h3",null,{"className":"text-neutral-strong font-circular-regular text-xl py-4","id":"register-the-entity-secret","children":"Register the Entity Secret"}],["$","p",null,{"className":"text-base","children":"You can register your Entity Secret in two ways: using the SDK, or using the Circle Console. The registration links your Entity Secret with your developer account, ensuring that you can confidently manage wallet creation and transactions with the assurance of robust security measures in place."}],["$","$L51",null,{"variant":"warning","children":[["$","p",null,{"className":"text-base","children":"As you proceed with the registration of your Entity Secret, pay close attention to the recovery file that will be generated. This file is a critical safety measure for your operations. In the event that your Entity Secret is ever lost, the recovery file will act as your fallback, enabling you to regain access to your Developer-Controlled Wallets. Ensure that you store this file securely and in a location that you can access readily if needed."}],["$","p",null,{"className":"text-base","children":[["$","strong",null,{"children":"Note:"}]," If you use the SDK to register the Entity Secret, the function downloads a recovery file named ",["$","em",null,{"className":"text-base font-circular-regular text-neutral italic","children":"recovery_file_.dat"}],". Additionally, the function returns the content of the recovery file as a JSON response."]}]]}],["$","h3",null,{"className":"text-neutral-strong font-circular-regular text-xl py-4","id":"registering-your-entity-secret-using-the-sdk","children":"Registering your Entity Secret using the SDK"}],["$","p",null,{"className":"text-base","children":"You can use the sample code below as a guide to register your Entity Secret Ciphertext using the SDK."}],["$","$L4f",null,{"title":"Register your Entity Secret","children":[["$","$L50",null,{"language":"javascript","code":"import { registerEntitySecretCiphertext } from '@circle-fin/developer-controlled-wallets'\n\nconst response = await registerEntitySecretCiphertext({\n apiKey: '',\n entitySecret: ''\n})\nconsole.log(response.data?.recoveryFile)\n","title":"NodeJS SDK","children":["$","code",null,{"className":"bg-code text-sm p-1 rounded-sm language-javascript","children":"import { registerEntitySecretCiphertext } from '@circle-fin/developer-controlled-wallets'\n\nconst response = await registerEntitySecretCiphertext({\n apiKey: '',\n entitySecret: ''\n})\nconsole.log(response.data?.recoveryFile)\n"}]}],["$","$L50",null,{"language":"python","code":"from circle.web3 import utils\n\nresult = utils.register_entity_secret_ciphertext(api_key='your_api_key', entity_secret='new_entity_secret')\nprint(result)\n","title":"Python SDK","children":["$","code",null,{"className":"bg-code text-sm p-1 rounded-sm language-python","children":"from circle.web3 import utils\n\nresult = utils.register_entity_secret_ciphertext(api_key='your_api_key', entity_secret='new_entity_secret')\nprint(result)\n"}]}]]}],["$","h3",null,{"className":"text-neutral-strong font-circular-regular text-xl py-4","id":"registering-your-entity-secret-ciphertext-in-web3-services-console","children":"Registering Your Entity Secret Ciphertext in Web3 Services Console"}],["$","$L51",null,{"variant":"info","children":["$","p",null,{"className":"text-base","children":"If you want to register the Entity Secret within our Web3 Service Console, you need to safeguard your Entity Secret first by converting it to Ciphertext following the previous instructions."}]}],["$","p",null,{"className":"text-base","children":["You can use the ",["$","a",null,{"className":"text-interactive font-circular-medium hover:text-blue-400","target":"_blank","href":"https://console.circle.com/wallets/dev/configurator","children":"Configurator Page"}]," in Web3 Services Console to register your Entity Secret Ciphertext."]}],"$L55",["$","div",null,{"className":"py-2","children":["$","div",null,{"className":"rounded-lg border border-black-75 px-8 py-6","children":[["$","div",null,{"className":"flex flex-row items-center","children":["$","div",null,{"className":"mb-1 text-xl text-neutral-strong font-circular-medium","children":"Register your Entity Secret Ciphertext"}]}],["$","div",null,{"className":"text-neutral-subtle","children":"$undefined"}],["$","div",null,{"className":"space-x-2 mt-4","children":[["$","$L56","Register",{"path":"/wallets/dev/configurator","type":"console","children":["$","button",null,{"className":"inline-flex items-center justify-center relative outline-none type-label-md rounded-sm disabled:opacity-50 disabled:pointer-events-none text-invert bg-bold-interactive hover:bg-bold-interactive-hovered focus:bg-bold-interactive-hovered px-4 py-2.5 max-h-10","children":["$","div",null,{"className":"flex items-center justify-center space-x-2","children":[["$","div",null,{"children":"Register"}],["$","div",null,{"children":["$","svg",null,{"xmlns":"http://www.w3.org/2000/svg","viewBox":"0 0 24 24","fill":"currentColor","aria-hidden":"true","data-slot":"icon","aria-labelledby":"$undefined","className":"h-6 w-6","children":[null,["$","path",null,{"fillRule":"evenodd","d":"M15.75 2.25H21a.75.75 0 0 1 .75.75v5.25a.75.75 0 0 1-1.5 0V4.81L8.03 17.03a.75.75 0 0 1-1.06-1.06L19.19 3.75h-3.44a.75.75 0 0 1 0-1.5Zm-10.5 4.5a1.5 1.5 0 0 0-1.5 1.5v10.5a1.5 1.5 0 0 0 1.5 1.5h10.5a1.5 1.5 0 0 0 1.5-1.5V10.5a.75.75 0 0 1 1.5 0v8.25a3 3 0 0 1-3 3H5.25a3 3 0 0 1-3-3V8.25a3 3 0 0 1 3-3h8.25a.75.75 0 0 1 0 1.5H5.25Z","clipRule":"evenodd"}]]}]}]]}]}]}]]}]]}]}],["$","h3",null,{"className":"text-neutral-strong font-circular-regular text-xl py-4","id":"guarding-your-secrets--building-trust","children":"Guarding your secrets & building trust"}],["$","p",null,{"className":"text-base","children":"By meticulously completing the registration and protection of your Entity Secret, you've not only guaranteed the security of your key but also laid down a bedrock of trust for all activities involving our developer-controlled wallets. We prioritize the safety of your data and are committed to providing a seamless and secure user experience."}]]]}],"\n",["$","div",null,{"className":"w-full py-6 border-b border-neutral-subtle space-y-4 first:pt-0 last:pb-0 last:border-0","children":[["$","h2",null,{"className":"text-neutral font-circular-medium text-2xl first:pt-0 pt-2","id":"create-a-wallet","children":"Create a Wallet"}],[["$","p",null,{"className":"text-base","children":"Welcome to a foundational step in utilizing our Web3 Services: initiating your first API call to construct a WalletSet. We'll guide you through the process and clarify what a WalletSet entails within our platform."}],["$","h3",null,{"className":"text-neutral-strong font-circular-regular text-xl py-4","id":"defining-a-walletset","children":"Defining a WalletSet"}],["$","p",null,{"className":"text-base","children":"A WalletSet within our ecosystem is a sophisticated grouping of wallets, securely tied together by a singular cryptographic key. Leveraging the Hierarchical Deterministic (HD) wallet technology, WalletSets offer an enhanced way to handle wallet management that spans multiple blockchain networks. This is particularly relevant for Ethereum Virtual Machine (EVM) compatible blockchains, where it is common for wallets on different networks to share the same address, thanks to the underlying technology."}],["$","h3",null,{"className":"text-neutral-strong font-circular-regular text-xl py-4","id":"grasping-the-concept-of-idempotency","children":"Grasping the concept of idempotency"}],["$","p",null,{"className":"text-base","children":"As we approach the creation of your inaugural WalletSet, it's important to comprehend a critical aspect of our APIs: idempotency keys."}],["$","p",null,{"className":"text-base","children":"Idempotency is a fundamental concept which guarantees that an operation is repeatable without changing the outcome. This concept is extremely important in API requests to make sure that if a request is accidentally sent more than once, it doesn't result in duplicate operations."}],["$","p",null,{"className":"text-base","children":"Consider situations like an unstable internet connection leading to multiple unintentional request submissions, or a user who accidentally activates a command several times. Without idempotency, such events might cause numerous unwanted operations."}],["$","p",null,{"className":"text-base","children":"To prevent this, an idempotency key is used. Each request includes a distinct key that, when recognized by the server within a certain timeframe as a repeat submission, prevents the repeated processing of that request. This mechanism is crucial to preserving the integrity of your operations, ensuring that only intended actions are carried out."}],["$","h3",null,{"className":"text-neutral-strong font-circular-regular text-xl py-4","id":"crafting-your-walletset","children":"Crafting Your WalletSet"}],["$","p",null,{"className":"text-base","children":"Now that we've got the concept of idempotency covered, let's look at creating your WalletSet."}],["$","div",null,{"className":"py-2","children":["$","div",null,{"className":"w-full rounded-sm border-neutral-subtle border overflow-hidden","children":["$","table",null,{"className":"text-left w-full table-fixed","children":[["$","thead",null,{"className":"w-full","children":["$","tr",null,{"className":"bg-primary border-b border-neutral-subtle w-full","children":[["$","th",null,{"className":"px-6 py-3 w-1/4","children":"Term"}],["$","th",null,{"className":"px-6 py-3 w-3/4","children":"Definition"}]]}]}],["$","tbody",null,{"className":"divide-y divide-neutral-subtle w-full","children":[["$","tr",null,{"children":[["$","td",null,{"className":"px-6 py-3 text-left align-top w-1/4","children":["$","strong",null,{"children":"idempotencyKey"}]}],["$","td",null,{"className":"px-6 py-3 text-left align-top w-3/4 space-y-4","children":["$","p",null,{"className":"text-base","children":"Think of this as a safety net. By using a unique UUID for every transaction\nrequest, you ensure no transaction is mistakenly processed more than once.\nIt's a measure against unintended duplicates."}]}]]}],["$","tr",null,{"children":[["$","td",null,{"className":"px-6 py-3 text-left align-top w-1/4","children":["$","strong",null,{"children":"entitySecretCiphertext"}]}],["$","td",null,{"className":"px-6 py-3 text-left align-top w-3/4 space-y-4","children":["$","p",null,{"className":"text-base","children":"Remember the encryption we discussed earlier? You'll need to provide this\nencrypted string for security and authorization."}]}]]}],["$","tr",null,{"children":[["$","td",null,{"className":"px-6 py-3 text-left align-top w-1/4","children":["$","strong",null,{"children":"name"}]}],["$","td",null,{"className":"px-6 py-3 text-left align-top w-3/4 space-y-4","children":["$","p",null,{"className":"text-base","children":"The name for your new WalletSet."}]}]]}]]}]]}]}]}],["$","p",null,{"className":"text-base","children":"Let's create our first wallet set!"}],["$","$L52",null,{"title":"Create a WalletSet","url":"/quickstarts/api/common/wallet-set","config":{"method":"POST","url":"/v1/w3s/developer/walletSets","headers":{"Content-Type":"application/json","Authorization":"Bearer "},"body":{"idempotencyKey":"","entitySecretCipherText":"","name":""}},"copy":[{"key":"walletSetId","path":"data.walletSet.id"}]}],["$","$L51",null,{"variant":"info","children":["$","p",null,{"className":"text-base","children":"Ensure that your idempotency key is unique for every distinct request. Our\nAPIs require the idempotency key to be of type uuidv4. Remember, its primary\nrole is to ensure that the same request isn't processed more than once."}]}],["$","h3",null,{"className":"text-neutral-strong font-circular-regular text-xl py-4","id":"utilizing-api-logs-for-enhanced-monitoring","children":"Utilizing API Logs for Enhanced Monitoring"}],["$","p",null,{"className":"text-base","children":["For a comprehensive overview of each transaction you execute with Circle's Web3 APIs, the Web3 Services Console provides detailed access to API logs. By examining these logs, you gain valuable visibility into how your application interacts with Circle APIs, which can be pivotal for various aspects including troubleshooting, performance optimization, and security oversight by highlighting any abnormal activities. For detailed records of your API interactions, please refer to the ",["$","$L56",null,{"path":"/logs","type":"console","children":"API Logs section"}],"."]}],["$","p",null,{"className":"text-base","children":"Within the scope of our Quickstart guide, the API log is indispensable for gaining insights into specific API calls and the objects that are created as a result. Think of the API log as a detailed record that allows you to retrieve the unique IDs of objects that have been generated, especially when these IDs are needed for subsequent API interactions. API logs are a crucial educational resource that simplify the debugging process and help you methodically comprehend the intricacies of the API's operations. Hence, the API log is not only instrumental in improving operational workflows but also serves as a valuable asset for your development projects."}],["$","p",null,{"className":"text-base","children":"Ah, the most exhilarating phase: shaping your very first developer-controlled wallet in the vastness of web3. With your prepped API key and Entity Secret Ciphertext, we're only a few steps away from crafting a masterpiece. Let's dive right in!"}],["$","h3",null,{"className":"text-neutral-strong font-circular-regular text-xl py-4","id":"understanding-the-developer-controlled-wallet","children":"Understanding the Developer-Controlled Wallet"}],["$","p",null,{"className":"text-base","children":"In web3, a wallet isn't just a storage mechanism for digital tokens or NFTs, but the very essence of user interactions on the blockchain. Essentially, it's a blend of a unique address and accompanying metadata stored on the blockchain."}],["$","p",null,{"className":"text-base","children":"For developer-controlled wallets:"}],["$","div",null,{"className":"w-full py-2","children":["$","div",null,{"className":"border border-neutral-subtle p-6 grid grid-cols-1 rounded-lg gap-6 bg-primary lg:grid-cols-2 bg-white","data-testid":"features-background","children":[["$","div",null,{"className":"flex items-start justify-start","children":[["$","$L4e",null,{"className":"mr-2 mt-1 h-5 w-5 shrink-0 text-blue-600","name":"BookOpenOutline"}],["$","div",null,{"children":[["$","p",null,{"className":"text-base","children":["$","strong",null,{"className":"-mt-px mb-1 flex items-center text-base text-neutral-strong font-circular-bold","children":["Address",null]}]}],["$","div",null,{"className":"text-sm text-neutral font-circular-regular","children":["$","p",null,{"className":"text-base","children":"A unique identifier on a blockchain. Notably, while an address remains\ndistinct, multiple wallets can have the same address across different EVM\nblockchains."}]}]]}]]}],["$","div",null,{"className":"flex items-start justify-start","children":[["$","$L4e",null,{"className":"mr-2 mt-1 h-5 w-5 shrink-0 text-blue-600","name":"KeyOutline"}],["$","div",null,{"children":[["$","p",null,{"className":"text-base","children":["$","strong",null,{"className":"-mt-px mb-1 flex items-center text-base text-neutral-strong font-circular-bold","children":["Custody Type",null]}]}],["$","div",null,{"className":"text-sm text-neutral font-circular-regular","children":["$","p",null,{"className":"text-base","children":"This signifies who controls the private key invocation — either the user\nor the developer. For our purpose, we're focusing on developer-controlled\nwallets, which are inherently more manageable and tailored for specific\napp requirements."}]}]]}]]}]]}]}],["$","p",null,{"className":"text-base","children":"With that foundational knowledge, let's get to the hands-on part."}],["$","h3",null,{"className":"text-neutral-strong font-circular-regular text-xl py-4","id":"crafting-your-wallet","children":"Crafting your wallet"}],["$","p",null,{"className":"text-base","children":"To create a wallet you use the following parameters:"}],["$","div",null,{"className":"py-2","children":["$","div",null,{"className":"w-full rounded-sm border-neutral-subtle border overflow-hidden","children":["$","table",null,{"className":"text-left w-full table-fixed","children":[["$","thead",null,{"className":"w-full","children":["$","tr",null,{"className":"bg-primary border-b border-neutral-subtle w-full","children":[["$","th",null,{"className":"px-6 py-3 w-1/4","children":"Term"}],["$","th",null,{"className":"px-6 py-3 w-3/4","children":"Definition"}]]}]}],["$","tbody",null,{"className":"divide-y divide-neutral-subtle w-full","children":[["$","tr",null,{"children":[["$","td",null,{"className":"px-6 py-3 text-left align-top w-1/4","children":["$","strong",null,{"children":"idempotencyKey"}]}],["$","td",null,{"className":"px-6 py-3 text-left align-top w-3/4 space-y-4","children":["$","p",null,{"className":"text-base","children":"Ensures that a request is executed only once, even if it's received multiple\ntimes."}]}]]}],["$","tr",null,{"children":[["$","td",null,{"className":"px-6 py-3 text-left align-top w-1/4","children":["$","strong",null,{"children":"entitySecretCiphertext"}]}],["$","td",null,{"className":"px-6 py-3 text-left align-top w-3/4 space-y-4","children":["$","p",null,{"className":"text-base","children":"The encrypted form of your Entity Secret, ensuring robust security for your\nAPI requests."}]}]]}],["$","tr",null,{"children":[["$","td",null,{"className":"px-6 py-3 text-left align-top w-1/4","children":["$","strong",null,{"children":"walletSetId"}]}],["$","td",null,{"className":"px-6 py-3 text-left align-top w-3/4 space-y-4","children":["$","p",null,{"className":"text-base","children":"The ID of the wallet set that you created in the preceding step."}]}]]}],["$","tr",null,{"children":[["$","td",null,{"className":"px-6 py-3 text-left align-top w-1/4","children":["$","strong",null,{"children":"blockchains"}]}],["$","td",null,{"className":"px-6 py-3 text-left align-top w-3/4 space-y-4","children":["$","p",null,{"className":"text-base","children":"Specifies the blockchains on which the wallet should be manifested."}]}]]}],["$","tr",null,{"children":[["$","td",null,{"className":"px-6 py-3 text-left align-top w-1/4","children":["$","strong",null,{"children":"count"}]}],["$","td",null,{"className":"px-6 py-3 text-left align-top w-3/4 space-y-4","children":["$","p",null,{"className":"text-base","children":["The number of wallets you aim to create. ",["$","strong",null,{"children":"Note:"}]," The parameter should not\nexceed 20."]}]}]]}]]}]]}]}]}],["$","$L51",null,{"variant":"info","children":["$","p",null,{"className":"text-base","children":["To ensure the best possible experience, we will automatically create and fund\ntwo wallets with testnet tokens. Each wallet will be funded with ",["$","strong",null,{"children":"10 USDC"}],", allowing you to dive right into the\nQuickstart without delay. Rest assured, this amount will be sufficient for you\nto initiate your first transaction."]}]}],["$","$L52",null,{"title":"Create your first wallets","url":"/quickstarts/api/dev-controlled/wallets","config":{"method":"POST","url":"/v1/w3s/developer/wallets","headers":{"Content-Type":"application/json","Authorization":"Bearer "},"body":{"idempotencyKey":"","entitySecretCipherText":"","blockchains":["","",""],"count":2,"walletSetId":""}},"copy":[{"path":"data.wallets[0].id","key":"devCWalletId"},{"path":"data.wallets[1].address","key":"devCDestinationAddress"}]}],["$","p",null,{"className":"text-base","children":"And there you have it! By the end of this step, you'll have fully functional developer-controlled wallets, ready to shape web3 experiences."}]]]}],"\n",["$","div",null,{"className":"w-full py-6 border-b border-neutral-subtle space-y-4 first:pt-0 last:pb-0 last:border-0","children":[["$","h2",null,{"className":"text-neutral font-circular-medium text-2xl first:pt-0 pt-2","id":"initiate-a-transaction","children":"Initiate a Transaction"}],[["$","p",null,{"className":"text-base","children":"Now that you have a wallet that contains some Testnet tokens, let's dive into initiating your first transaction. It's simpler than you might think, especially with our streamlined approach."}],["$","$L51",null,{"variant":"info","children":["$","p",null,{"className":"text-base","children":[["$","strong",null,{"children":"Cross-Blockchain Transfers:"}]," Tokens are native to specific blockchains,\nmeaning they can't be sent directly across different chains. For instance,\nEthereum tokens stay on the Ethereum network unless other mechanisms, like\nbridges, are used."]}]}],["$","h3",null,{"className":"text-neutral-strong font-circular-regular text-xl py-4","id":"getting-the-tokenid","children":"Getting the tokenId"}],["$","p",null,{"className":"text-base","children":["Before we can proceed, we need to determine the ",["$","code",null,{"className":"bg-code text-sm p-1 rounded-sm","children":"tokenId"}],". You can do this by retrieving the token balances for your wallet."]}],["$","$L52",null,{"title":"Get your wallet balance","url":"/quickstarts/api/dev-controlled/balance","config":{"url":"/v1/w3s/wallets/__WALLET_ID__/balances","headers":{"Content-Type":"application/json","Authorization":"Bearer "},"method":"GET"},"copy":[{"path":"data.tokenBalances[1].token.id","key":"devCTokenId"}]}],["$","h3",null,{"className":"text-neutral-strong font-circular-regular text-xl py-4","id":"key-transaction-parameters","children":["$","strong",null,{"children":"Key Transaction Parameters:"}]}],["$","div",null,{"className":"py-2","children":["$","div",null,{"className":"w-full rounded-sm border-neutral-subtle border overflow-hidden","children":["$","table",null,{"className":"text-left w-full table-fixed","children":[["$","thead",null,{"className":"w-full","children":["$","tr",null,{"className":"bg-primary border-b border-neutral-subtle w-full","children":[["$","th",null,{"className":"px-6 py-3 w-1/4","children":"Term"}],["$","th",null,{"className":"px-6 py-3 w-3/4","children":"Definition"}]]}]}],["$","tbody",null,{"className":"divide-y divide-neutral-subtle w-full","children":[["$","tr",null,{"children":[["$","td",null,{"className":"px-6 py-3 text-left align-top w-1/4","children":["$","strong",null,{"children":"idempotencyKey"}]}],["$","td",null,{"className":"px-6 py-3 text-left align-top w-3/4 space-y-4","children":["$","p",null,{"className":"text-base","children":"A unique string that ensures your transaction isn 't processed more than\nonce even if sent multiple times. A critical measure to prevent duplicates."}]}]]}],["$","tr",null,{"children":[["$","td",null,{"className":"px-6 py-3 text-left align-top w-1/4","children":["$","strong",null,{"children":"amounts"}]}],["$","td",null,{"className":"px-6 py-3 text-left align-top w-3/4 space-y-4","children":["$","p",null,{"className":"text-base","children":"Specify the amount of tokens you're transferring."}]}]]}],["$","tr",null,{"children":[["$","td",null,{"className":"px-6 py-3 text-left align-top w-1/4","children":["$","strong",null,{"children":"destinationAddress"}]}],["$","td",null,{"className":"px-6 py-3 text-left align-top w-3/4 space-y-4","children":["$","p",null,{"className":"text-base","children":"The wallet address where you're sending the tokens."}]}]]}],["$","tr",null,{"children":[["$","td",null,{"className":"px-6 py-3 text-left align-top w-1/4","children":["$","strong",null,{"children":"entitySecretCiphertext"}]}],["$","td",null,{"className":"px-6 py-3 text-left align-top w-3/4 space-y-4","children":["$","p",null,{"className":"text-base","children":"A crucial security layer, this encrypted string ensures only authorized\ntransactions go through."}]}]]}],["$","tr",null,{"children":[["$","td",null,{"className":"px-6 py-3 text-left align-top w-1/4","children":["$","strong",null,{"children":"tokenId"}]}],["$","td",null,{"className":"px-6 py-3 text-left align-top w-3/4 space-y-4","children":["$","p",null,{"className":"text-base","children":"This is the id we just extract from your wallet balance. It is the unique\nidentifier for the specific token type you're moving. This id is unique."}]}]]}],["$","tr",null,{"children":[["$","td",null,{"className":"px-6 py-3 text-left align-top w-1/4","children":["$","strong",null,{"children":"walletId"}]}],["$","td",null,{"className":"px-6 py-3 text-left align-top w-3/4 space-y-4","children":["$","p",null,{"className":"text-base","children":"Indicates the source of the transaction, i.e., from which wallet you're\nsending the tokens."}]}]]}]]}]]}]}]}],["$","p",null,{"className":"text-base","children":["The preceding parameters are just the essentials for initiating a transaction. The endpoint offers a richer, more detailed configuration to cater to a variety of transaction types. For a comprehensive list of the supported parameters, see the ",["$","$L56",null,{"type":"internal","path":"/api-reference/w3s/developer-controlled-wallets/create-developer-transaction-transfer","children":"official documentation"}],"."]}],["$","$L52",null,{"title":"Initiate your transaction","url":"/quickstarts/api/dev-controlled/create-transaction","config":{"url":"/v1/w3s/developer/transactions/transfer","method":"POST","headers":{"Content-Type":"application/json","Authorization":"Bearer "},"body":{"idempotencyKey":"","entitySecretCipherText":"","amounts":[""],"feeLevel":"HIGH","tokenId":"","walletId":""}}}],["$","$L51",null,{"variant":"info","children":["$","p",null,{"className":"text-base","children":["Blockchain transactions pose a challenge with gas fees. Gas fees are charges\nin blockchain networks, typically paid with native assets like Ether (ETH) on\nEthereum. This complicates the user experience as it requires users to hold\nthese assets. However, with ",["$","strong",null,{"children":"Developer-Controlled smart contract wallets"}],",\nyou can sponsor gas fees, removing the need to possess native assets. The\n",["$","strong",null,{"children":"Gas Station"}]," acts as an intermediary, allowing you to cover fees for your\nusers, improving their transaction experience. In testnet, the Gas Station is\nalready setup for you, ready for testing. In the Production phase, you gain\nmore control with spending limits and configuration options. Learn more\n",["$","a",null,{"className":"text-interactive font-circular-medium hover:text-blue-400","target":"_self","href":"/w3s/gas-station","children":"here"}],"."]}]}],["$","p",null,{"className":"text-base","children":"Once you've validated your transaction and everything checks out, you're all set. Transactions on the blockchain are immutable, meaning once they're validated, they cannot be reversed or altered. So, always double-check before sending!"}],["$","p",null,{"className":"text-base","children":["After initiating a transaction through our API, you can look up the transaction hash on the ",["$","$L56",null,{"type":"console","path":"/wallets/dev/transactions","children":"Dev Controlled Wallets Transactions"}]," page for in the Web3 Services Console. The transaction hash is a unique identifier for your transaction."]}],["$","p",null,{"className":"text-base","children":"You can validate transactions in multiple ways:"}],["$","$L57",null,{"children":[["$","$L58",null,{"label":"Web3 Services Console","children":[["$","p",null,{"className":"text-base","children":"This is the preferred method. It enables you to inspect the transaction state directly."}],["$","ol",null,{"children":[["$","li",null,{"children":[["$","div",null,{"className":"flex items-start justify-start gap-x-4","children":[["$","div",null,{"className":"flex h-8 w-8 items-center justify-center rounded-full border border-black-200 p-2 text-neutral-subtle","data-testid":"step-index-1","children":1}],["$","h4",null,{"className":"text-xl text-neutral-strong font-circular-medium","children":"Log in to the Console"}]]}],["$","div",null,{"className":"my-2 ml-4 pl-8 space-y-4 pb-4 [&>*]:pb-0 border-l border-black-50","data-testid":"step-separator-1","children":["$","p",null,{"className":"text-base","children":"Make sure you're logged in to our Web3 Services Console."}]}]]}],["$","li",null,{"children":[["$","div",null,{"className":"flex items-start justify-start gap-x-4","children":[["$","div",null,{"className":"flex h-8 w-8 items-center justify-center rounded-full border border-black-200 p-2 text-neutral-subtle","data-testid":"step-index-2","children":2}],["$","h4",null,{"className":"text-xl text-neutral-strong font-circular-medium","children":"Open the transactions page"}]]}],["$","div",null,{"className":"my-2 ml-4 pl-8 space-y-4 pb-4 [&>*]:pb-0 border-l border-black-50","data-testid":"step-separator-2","children":[["$","p",null,{"className":"text-base","children":["Open the ",["$","$L56",null,{"path":"/wallets/dev/transactions","type":"console","children":"Dev Controlled Wallets Transactions"}]," page."]}],["$","p",null,{"className":"text-base","children":"You can see the state of your transaction directly in the table."}],"$L59"]}]]}],["$","li",null,{"children":[["$","div",null,{"className":"flex items-start justify-start gap-x-4","children":[["$","div",null,{"className":"flex h-8 w-8 items-center justify-center rounded-full border border-black-200 p-2 text-neutral-subtle","data-testid":"step-index-3","children":3}],["$","h4",null,{"className":"text-xl text-neutral-strong font-circular-medium","children":"Open Transaction Details"}]]}],["$","div",null,{"className":"my-2 ml-4 pl-8 space-y-4 pb-4 [&>*]:pb-0","data-testid":"step-separator-3","children":["$","p",null,{"className":"text-base","children":"For more details about your transaction, click on the relevant line in the transaction details."}]}]]}]]}]]}],["$","$L58",null,{"label":"Blockchain Explorer","children":[["$","p",null,{"className":"text-base","children":"By using the transaction hash or wallet id, you can view the transaction state on a blockchain explorer."}],["$","ol",null,{"children":[["$","li",null,{"children":[["$","div",null,{"className":"flex items-start justify-start gap-x-4","children":[["$","div",null,{"className":"flex h-8 w-8 items-center justify-center rounded-full border border-black-200 p-2 text-neutral-subtle","data-testid":"step-index-1","children":1}],["$","h4",null,{"className":"text-xl text-neutral-strong font-circular-medium","children":"Choose a Blockchain Explorer"}]]}],["$","div",null,{"className":"my-2 ml-4 pl-8 space-y-4 pb-4 [&>*]:pb-0 border-l border-black-50","data-testid":"step-separator-1","children":[["$","p",null,{"className":"text-base","children":"Depending on the blockchain your token resides on, select a suitable explorer:"}],["$","ul",null,{"className":"ml-4 list-outside list-disc pb-2 marker:text-black marker:text-left [&>li]:pl-2","children":["\n",["$","li",null,{"children":["Ethereum: ",["$","$L56",null,{"type":"external","path":"https://sepolia.etherscan.io/","children":"Etherscan"}]]}],"\n",["$","li",null,{"children":["Polygon: ",["$","$L56",null,{"type":"external","path":"https://amoy.polygonscan.com/","children":"Polygonscan"}]]}],"\n",["$","li",null,{"children":["Avalanche: ",["$","$L56",null,{"type":"external","path":"https://testnet.snowtrace.io/","children":"Snowtrace"}]]}],"\n"]}]]}]]}],["$","li",null,{"children":[["$","div",null,{"className":"flex items-start justify-start gap-x-4","children":[["$","div",null,{"className":"flex h-8 w-8 items-center justify-center rounded-full border border-black-200 p-2 text-neutral-subtle","data-testid":"step-index-2","children":2}],["$","h4",null,{"className":"text-xl text-neutral-strong font-circular-medium","children":"Input your Transaction Hash or Wallet Id"}]]}],["$","div",null,{"className":"my-2 ml-4 pl-8 space-y-4 pb-4 [&>*]:pb-0 border-l border-black-50","data-testid":"step-separator-2","children":["$","p",null,{"className":"text-base","children":["On the explorer's main page, there's a search bar. Paste your transaction hash or wallet id\nthere and search. You can find the transactionHash or the wallet id in your ",["$","$L56",null,{"type":"console","path":"/wallets/dev/transactions","children":"list of transactions"}],"."]}]}]]}],["$","li",null,{"children":[["$","div",null,{"className":"flex items-start justify-start gap-x-4","children":[["$","div",null,{"className":"flex h-8 w-8 items-center justify-center rounded-full border border-black-200 p-2 text-neutral-subtle","data-testid":"step-index-3","children":3}],["$","h4",null,{"className":"text-xl text-neutral-strong font-circular-medium","children":"Review Details"}]]}],["$","div",null,{"className":"my-2 ml-4 pl-8 space-y-4 pb-4 [&>*]:pb-0","data-testid":"step-separator-3","children":[["$","p",null,{"className":"text-base","children":"Whether you provide a wallet ID or transaction hash, details regarding your wallet and the associated transactions will be visible. This includes particularities of each transaction such as the number of confirmations and the gas used, letting you verify that all aligns with your expectations."}],"$L5a"]}]]}]]}]]}]]}]]]}],"\n",["$","div",null,{"className":"w-full py-6 border-b border-neutral-subtle space-y-4 first:pt-0 last:pb-0 last:border-0","children":[["$","h2",null,{"className":"text-neutral font-circular-medium text-2xl first:pt-0 pt-2","id":"congratulations-on-your-progress","children":"Congratulations on your Progress!"}],[["$","div",null,{"className":"w-full py-2","children":["$","div",null,{"className":"border border-neutral-subtle p-6 grid grid-cols-1 rounded-lg gap-6 bg-white","data-testid":"features-background","children":[["$","div",null,{"className":"flex items-start justify-start","children":[["$","$L4e",null,{"className":"mr-2 mt-1 h-5 w-5 shrink-0 text-blue-600","name":"CheckOutline"}],["$","div",null,{"children":[["$","strong",null,{"className":"-mt-px mb-1 flex items-center text-base text-neutral-strong font-circular-bold","children":[["$","p",null,{"className":"text-base","children":"Established your Entity Secret"}],null]}],["$","div",null,{"className":"text-sm text-neutral font-circular-regular","children":["$","p",null,{"className":"text-base","children":"You took the initiative to generate and secure your unique Entity Secret,\nensuring that your interactions remain encrypted and safe."}]}]]}]]}],["$","div",null,{"className":"flex items-start justify-start","children":[["$","$L4e",null,{"className":"mr-2 mt-1 h-5 w-5 shrink-0 text-blue-600","name":"CheckOutline"}],["$","div",null,{"children":[["$","strong",null,{"className":"-mt-px mb-1 flex items-center text-base text-neutral-strong font-circular-bold","children":[["$","p",null,{"className":"text-base","children":"Created your first Developer Controlled Wallet"}],null]}],["$","div",null,{"className":"text-sm text-neutral font-circular-regular","children":["$","p",null,{"className":"text-base","children":"By setting up your wallet, you now possess a powerful tool that allows you\nto engage with web3 networks with full autonomy."}]}]]}]]}],["$","div",null,{"className":"flex items-start justify-start","children":[["$","$L4e",null,{"className":"mr-2 mt-1 h-5 w-5 shrink-0 text-blue-600","name":"CheckOutline"}],["$","div",null,{"children":[["$","strong",null,{"className":"-mt-px mb-1 flex items-center text-base text-neutral-strong font-circular-bold","children":[["$","p",null,{"className":"text-base","children":"Got Testnet tokens via faucets"}],null]}],["$","div",null,{"className":"text-sm text-neutral font-circular-regular","children":["$","p",null,{"className":"text-base","children":"You've effectively tapped into the Faucets, filling your wallets with\nTestnet tokens, a crucial step for practical, risk-free experimentation on\nTestnet."}]}]]}]]}],["$","div",null,{"className":"flex items-start justify-start","children":[["$","$L4e",null,{"className":"mr-2 mt-1 h-5 w-5 shrink-0 text-blue-600","name":"CheckOutline"}],["$","div",null,{"children":[["$","strong",null,{"className":"-mt-px mb-1 flex items-center text-base text-neutral-strong font-circular-bold","children":[["$","p",null,{"className":"text-base","children":"Initiated a blockchain transaction & validated it"}],null]}],["$","div",null,{"className":"text-sm text-neutral font-circular-regular","children":["$","p",null,{"className":"text-base","children":"Not only did you initiate a blockchain transaction, but you also took the\nproactive step of validating it using blockchain explorers, assuring\ntransparency and trust in every move."}]}]]}]]}]]}]}],["$","h3",null,{"className":"text-neutral-strong font-circular-regular text-xl py-4","id":"stay-connected--explore-more","children":"Stay connected & Explore more"}],["$","p",null,{"className":"text-base","children":"Your journey with us doesn't stop here. There's so much more to discover und dive into:"}],["$","div",null,{"className":"w-full py-2","children":["$","div",null,{"className":"border border-neutral-subtle p-6 grid grid-cols-1 rounded-lg gap-6 bg-white","data-testid":"features-background","children":[["$","div",null,{"className":"flex items-start justify-start","children":[["$","$L4e",null,{"className":"mr-2 mt-1 h-5 w-5 shrink-0 text-blue-600","name":"BookOpenOutline"}],["$","div",null,{"children":[["$","strong",null,{"className":"-mt-px mb-1 flex items-center text-base text-neutral-strong font-circular-bold","children":[["$","p",null,{"className":"text-base","children":"Dive into our documentation"}],["$","$L56",null,{"path":"/w3s/circle-programmable-wallets-an-overview","type":"internal","className":"ml-2","children":["$","$L4e",null,{"className":"size-4","name":"ExternalLinkOutline"}]}]]}],["$","div",null,{"className":"text-sm text-neutral font-circular-regular","children":["$","p",null,{"className":"text-base","children":"Your comprehensive resource for understanding our web3 tools,\ntechnologies, and best practices."}]}]]}]]}],["$","div",null,{"className":"flex items-start justify-start","children":[["$","$L4e",null,{"className":"mr-2 mt-1 h-5 w-5 shrink-0 text-blue-600","name":"ChatOutline"}],["$","div",null,{"children":[["$","strong",null,{"className":"-mt-px mb-1 flex items-center text-base text-neutral-strong font-circular-bold","children":[["$","p",null,{"className":"text-base","children":"Join our Discord server"}],["$","$L56",null,{"path":"https://discord.com/invite/buildoncircle","type":"external","className":"ml-2","children":["$","$L4e",null,{"className":"size-4","name":"ExternalLinkOutline"}]}]]}],["$","div",null,{"className":"text-sm text-neutral font-circular-regular","children":["$","p",null,{"className":"text-base","children":"Engage, ask, share, and collaborate. Become an integral part of our\nvibrant developer community."}]}]]}]]}],["$","div",null,{"className":"flex items-start justify-start","children":[["$","$L4e",null,{"className":"mr-2 mt-1 h-5 w-5 shrink-0 text-blue-600","name":"CodeOutline"}],["$","div",null,{"children":[["$","strong",null,{"className":"-mt-px mb-1 flex items-center text-base text-neutral-strong font-circular-bold","children":[["$","p",null,{"className":"text-base","children":"Sample Apps"}],["$","$L56",null,{"path":"https://github.com/orgs/circlefin/repositories","type":"external","className":"ml-2","children":["$","$L4e",null,{"className":"size-4","name":"ExternalLinkOutline"}]}]]}],["$","div",null,{"className":"text-sm text-neutral font-circular-regular","children":["$","p",null,{"className":"text-base","children":"Get hands-on with real-world use cases, or gain inspiration for your next\nbig project."}]}]]}]]}],["$","div",null,{"className":"flex items-start justify-start","children":[["$","$L4e",null,{"className":"mr-2 mt-1 h-5 w-5 shrink-0 text-blue-600","name":"LightBulbOutline"}],["$","div",null,{"children":[["$","strong",null,{"className":"-mt-px mb-1 flex items-center text-base text-neutral-strong font-circular-bold","children":[["$","p",null,{"className":"text-base","children":"Start building with our SDKs"}],["$","$L56",null,{"path":"/w3s/web3-services-sdks","type":"internal","className":"ml-2","children":["$","$L4e",null,{"className":"size-4","name":"ExternalLinkOutline"}]}]]}],["$","div",null,{"className":"text-sm text-neutral font-circular-regular","children":["$","p",null,{"className":"text-base","children":"Explore our server and client-side SDKs to start building."}]}]]}]]}]]}]}],["$","p",null,{"className":"text-base","children":[["$","strong",null,{"children":"Engage, Build, Share!"}]," Dive into our forums, share your feedback, and keep an eye out for exciting challenges and hackathons. Your unique perspective and skills are valuable, and we're eager to see the innovations you'll introduce to our growing ecosystem."]}],["$","h3",null,{"className":"text-neutral-strong font-circular-regular text-xl py-4","id":"your-feedback-matters","children":"Your feedback matters"}],["$","p",null,{"className":"text-base","children":"Before you embark further on your journey, we'd love to hear from you. Your feedback shapes the future of our platform and helps us provide a better experience for all developers."}],["$","p",null,{"className":"text-base","children":"What did you love about the process? Was there something you wish was different? Every insight, no matter how small, matters to us."}],["$","$L5b",null,{"children":["$","p",null,{"className":"text-base","children":["$","button",null,{"className":"inline-flex items-center justify-center relative outline-none type-label-md rounded-sm disabled:opacity-50 disabled:pointer-events-none text-invert bg-bold-interactive hover:bg-bold-interactive-hovered focus:bg-bold-interactive-hovered px-4 py-2.5 max-h-10","children":"Give Feedback"}]}]}],["$","p",null,{"className":"text-base","children":"Thank you for your trust, dedication, and enthusiasm. Here's to the next chapter in your web3 journey and the marvelous innovations you'll bring forth."}],["$","p",null,{"className":"text-base","children":[["$","strong",null,{"children":"Happy Building!"}]," 🚀"]}],["$","br",null,{}],["$","p",null,{"className":"text-base","children":["$","strong",null,{"children":"Next: Explore more Quickstarts"}]}],["$","$L5c",null,{"selected":["UCW","CCTP"]}]]]}]]}]}],["$","div",null,{"className":"border-t border-neutral-subtle mt-14 pt-2","children":["$","$L5d",null,{"url":"interactive-quickstarts/dev-controlled-wallets"}]}]]}]]}]}],["$","div",null,{"className":"md:pl-sidebar","children":["$","div",null,{"className":"md:px-6","children":["$","$L5e",null,{}]}]}]]}]}]}]