diff --git a/pages/stack/features/custom-gas-tokens.mdx b/pages/stack/features/custom-gas-tokens.mdx new file mode 100644 index 000000000..fefaddb5e --- /dev/null +++ b/pages/stack/features/custom-gas-tokens.mdx @@ -0,0 +1,100 @@ +--- +title: Custom gas tokens +description: Learn about custom gass tokens +lang: en-US +content_type: notice +topic: custom-gas-tokens +personas: + - chain-operator +categories: + - security + - protocol + - infrastructure + - interoperability +is_imported_content: 'false' +--- + +# Custom Gas Token: Your Guide to Using Native Assets for Gas + +This guide explains how Custom Gas Token (CGT) works and what it means for you as a user or developer working with OP Stack chains. + +## What is Custom Gas Token? + +Think of Custom Gas Token as a way for blockchain networks to use their own special currency instead of ETH to pay for transaction fees. It's like a store that accepts its own gift cards instead of cash – you can still buy what you need, but you use a different payment method. + +Instead of paying gas fees with ETH, you'll pay with the network's native token. This opens up exciting possibilities for different types of blockchain economics and features. + +## How it works + +### The basics + +When a network enables Custom Gas Token, you can no longer use ETH to pay for transactions. Instead, the network's own token becomes the currency for gas fees. This change allows networks to create unique ways to distribute and manage their tokens, opening up new economic possibilities. + +### Key components you should know about + +**Native Asset Liquidity** +This is like a big vault that holds the network's native tokens. Think of it as the main supply storage. + +**Liquidity Controller** +This acts like a smart manager that controls who can access tokens from the vault. It ensures only authorized systems can mint (create) or burn (destroy) tokens. + +**Wrapped Native Asset (WNA)** +Just like WETH wraps ETH, WNA wraps the native token so it can work with applications that expect ERC-20 tokens. + +## What this means for you + +### As a regular user + +Getting native tokens depends on the specific network you're using. You might exchange other tokens for native tokens through a converter, bridge tokens from another blockchain, or receive them directly from the network. + +Once you have native tokens, using them is straightforward. They work just like ETH – they automatically get deducted when you make transactions. However, since each network handles native tokens differently, you'll want to check the network's documentation to understand how to move tokens in and out. + +### As a developer + +There are some key differences when working with CGT-enabled chains compared to ETH-based chains. Standard ETH deposit and withdrawal functions are disabled, so you'll need to integrate with the network's specific token management system. Native token acquisition methods also vary by implementation. + +The good news is that much stays the same. Transaction structure and gas calculation work similarly to what you're used to. Smart contracts deploy and function normally, and most development tools work without changes. + +## Benefits of Custom Gas Token + +Custom Gas Token opens up new possibilities for both networks and users. Networks can create unique economic models, use existing tokens as native assets, implement custom supply management, and enable novel bridging mechanisms. This flexibility allows for innovation in how blockchain economics work. + +For users, the main advantages include paying gas with tokens you already hold, participating in network-specific economics, and accessing unique features tied to the native token. This can make the user experience more integrated and potentially more cost-effective depending on the token economics. + +## Things to keep in mind + +### Flexibility comes with variety + +Since each CGT-enabled network can implement token management differently, it's important to read each network's specific documentation. You'll want to understand whether the native token comes from an existing ERC-20, a new token, or other mechanisms. If you're moving tokens between networks, make sure you understand and verify the security of the bridging mechanism being used. + +### Security considerations + +Only authorized systems can manage the token supply, with the network's governance controlling who gets minting permissions. This makes smart contract audits especially important for token management contracts. The security model is designed to prevent unauthorized token creation or destruction. + +## Getting started + +Getting started with a Custom Gas Token network involves a few straightforward steps. First, choose an OP Stack network that uses Custom Gas Token. Next, follow the network's specific process to acquire native tokens. Once you have tokens, you can start transacting using them just like you'd use ETH for gas. Finally, explore any unique features that the network offers tied to their native tokens. + +## Common scenarios + +### Scenario 1: L1 ERC-20 as native token + +If the network uses an existing L1 token, you'll bridge your L1 tokens to the L2 network where they become your gas currency. You can then use these bridged tokens for all transactions on the network. + +### Scenario 2: L2-native token + +If the network created its own token, you'll need to acquire tokens through the network's specific distribution method. These tokens often serve dual purposes, functioning both for utility or governance and as the gas payment method. Many of these networks also offer an ERC-20 version for use in DeFi applications. + +### Scenario 3: No existing token dependency + +Some networks create entirely new economic models where tokens might be earned through network participation. These networks often have unique supply schedules and economics that differ significantly from traditional models. + +## Need help? + +If you need assistance, start by checking your specific network's documentation for detailed instructions. Look for network-specific developer guides and examples if you're building applications. You can also join the network's community channels for support from other users and developers. + +Remember, while the core concept is consistent across CGT networks, implementation details vary. Always consult your specific network's documentation for the most accurate and up-to-date information. + +*** + +*This technology enables exciting new possibilities for blockchain economics while maintaining the security and functionality you expect from OP Stack networks.* diff --git a/words.txt b/words.txt index 55af6d53a..303445646 100644 --- a/words.txt +++ b/words.txt @@ -1,7 +1,7 @@ -accountqueue ACCOUNTQUEUE -accountslots +accountqueue ACCOUNTSLOTS +accountslots ACDC ADDI ADDIU @@ -9,58 +9,58 @@ ADDU airgap Allnodes allocs -alphanet Alphanet -alphanets +alphanet Alphanets +alphanets altda ANDI Ankr Apeworx Arweave authrpc -autorelay Autorelay +autorelay autorelayer basefee bcde -betanet Betanet -betanets +betanet Betanets +betanets BGEZ BGTZ Biconomy BLEZ -blobpool BLOBPOOL +blobpool blobspace Blockdaemon blockhash blocklists -blocklogs BLOCKLOGS -blockprofilerate +blocklogs BLOCKPROFILERATE +blockprofilerate Blockscout -blockspace Blockspace +blockspace blocktime -blocktimes Blocktimes -bloomfilter +blocktimes BLOOMFILTER +bloomfilter BLTZ Bootcamp bootnode -bootnodes -Bootnodes BOOTNODES +Bootnodes +bootnodes bottlenecked -brotli Brotli -callouts +brotli Callouts +callouts CCIP cdef Celestia @@ -73,71 +73,71 @@ chaosnet Chugsplash Clabby codebases -collateralized Collateralized +collateralized compr Comprensive -computependingblock COMPUTEPENDINGBLOCK +computependingblock confs corsdomain counterfactually -crosschain Crosschain +crosschain Crossmint daserver -datacap DATACAP -datadir +datacap DATADIR +datadir Defi Defillama's delegatecall -devnet Devnet -devnets +devnet Devnets +devnets devs direnv -disabletxpoolgossip DISABLETXPOOLGOSSIP -discv +disabletxpoolgossip Discv +discv DIVU Drand dripcheck Drippie Eigen EIPs -enabledeprecatedpersonal ENABLEDEPRECATEDPERSONAL +enabledeprecatedpersonal enginekind -erigon Erigon -etherbase +erigon ETHERBASE +etherbase Ethernity Ethernow -ethstats ETHSTATS -evmtimeout +ethstats EVMTIMEOUT +evmtimeout executability exfiltrate -exitwhensynced EXITWHENSYNCED +exitwhensynced extensibly -extradata EXTRADATA +extradata Farcaster Faultproof -fdlimit FDLIMIT +fdlimit flashblock flashblock's -flashblocks -Flashblocks FLASHBLOCKS +Flashblocks +flashblocks Flashbots forkable forkchoice @@ -145,51 +145,52 @@ FPVM FPVMs Fraxtal Funct -gascap GASCAP +gascap gaslessly -gcmode +gass GCMODE +gcmode Gelato gifs -globalqueue GLOBALQUEUE -globalslots +globalqueue GLOBALSLOTS +globalslots gokzg growthepie hardfork hardforks -healthcheck HEALTHCHECK +healthcheck healthchecks -historicalrpc HISTORICALRPC -historicalrpctimeout +historicalrpc HISTORICALRPCTIMEOUT -holesky -Holesky +historicalrpctimeout HOLESKY +Holesky +holesky IERC -ignoreprice IGNOREPRICE +ignoreprice Immunefi -inator Inator -influxdbv +inator INFLUXDBV +influxdbv initcode -ipcdisable IPCDISABLE +ipcdisable ipcfile -ipcpath IPCPATH +ipcpath IPFS JALR -journalremotes JOURNALREMOTES -jspath +journalremotes JSPATH +jspath jwtsecret Keccak leveldb @@ -198,34 +199,34 @@ Lisk logfile logfmt Mainnets -maxage MAXAGE -maxbackups +maxage MAXBACKUPS -maxpeers +maxbackups MAXPEERS -maxpendpeers +maxpeers MAXPENDPEERS -maxprice +maxpendpeers MAXPRICE -memprofilerate +maxprice MEMPROFILERATE -merkle +memprofilerate Merkle +merkle MFHI MFLO Mgas Minato -minfreedisk MINFREEDISK -minsuggestedpriorityfee +minfreedisk MINSUGGESTEDPRIORITYFEE +minsuggestedpriorityfee Mintable Mintplex MIPSEVM Mitigations -monitorism Monitorism +monitorism Moralis Mordor MOVN @@ -234,146 +235,146 @@ MTHI MTLO MULT multiaddr -multichain Multichain +multichain multiclient multisigs MULTU Nethermind -netrestrict NETRESTRICT -networkid +netrestrict NETWORKID -newpayload +networkid NEWPAYLOAD +newpayload nextra -nocompaction NOCOMPACTION -nodekey +nocompaction NODEKEY -nodekeyhex +nodekey NODEKEYHEX +nodekeyhex nodename Nodies -nodiscover NODISCOVER -nolocals +nodiscover NOLOCALS -noprefetch +nolocals NOPREFETCH -nopruning +noprefetch NOPRUNING -nosyncserve +nopruning NOSYNCSERVE +nosyncserve Numba NVME -offchain Offchain +offchain onlyreqtostatic opchaina opchainb -opcm OPCM +opcm Openfort oplabs opnode's outfile outperformance pcscdpath -pectra Pectra +pectra Pectra's -peerstore Peerstore +peerstore peerstores -permissioned Permissioned +permissioned permissioning -permissionless Permissionless +permissionless permissionlessly Perps Peta Pimlico POAP POAPs -pprof PPROF -precommitments +pprof Precommitments +precommitments preconfigured predeploy -predeployed Predeployed -predeploys +predeployed Predeploys +predeploys prefunded -preimage Preimage -preimages +preimage PREIMAGES +preimages preinstall -preinstalls Preinstalls -prestate +preinstalls Prestate +prestate prestates PREVRANDAO -pricebump PRICEBUMP -pricelimit +pricebump PRICELIMIT +pricelimit productionize productionized Protip -proxied Proxied -proxyd +proxied Proxyd +proxyd Pyth Pyth's QRNG -quicknode Quicknode +quicknode quickstarts rebalancing reemit Reemitting -regenesis Regenesis +regenesis Reimagine -rejournal REJOURNAL -remotedb +rejournal REMOTEDB +remotedb Reown Reown's replayability replayor reposts reproven -requiredblocks REQUIREDBLOCKS +requiredblocks rollouts -rollups Rollups +rollups Routescan rpckind -rpcprefix RPCPREFIX +rpcprefix rpcs RPGF -runbooks Runbooks +runbooks RWAs safedb Schnorr -sepolia -Sepolia SEPOLIA +Sepolia +sepolia seqnr -sequencerhttp SEQUENCERHTTP +sequencerhttp serv signup SLLV @@ -382,8 +383,8 @@ SLTIU SLTU smartcard snapshotlog -snapsync Snapsync +snapsync solady Solana Soneium @@ -391,8 +392,8 @@ soyboy Spearbit SRAV SRLV -stablecoins Stablecoins +stablecoins statefulset structs subcomponents @@ -401,21 +402,21 @@ subheaders subsecond SUBU Sunnyside -superchain -Superchain SUPERCHAIN -superchainerc +Superchain +superchain Superchain's +superchainerc Superlend Superloans Superscan Superseed -supersim Supersim -syncmode +supersim SYNCMODE -synctarget +syncmode SYNCTARGET +synctarget syscalls SYSCON thirdweb @@ -429,8 +430,8 @@ Twei txfeecap txmgr txns -txpool TXPOOL +txpool txproxy txproxyd uncensorable @@ -440,21 +441,21 @@ Unichain Unprotect unsubmitted UPNP -verkle VERKLE -vhosts +verkle VHOSTS -viem +vhosts Viem -viem's +viem Viem's -vmdebug +viem's VMDEBUG -vmodule +vmdebug VMODULE +vmodule xlarge XORI ZKPs ZKVM -zora Zora +zora