Frequently Asked Questions

CW20 is the standard specification for fungible tokens based on CosmWasm smart contracts operating on the sovereign luxa-1 Layer 1. It is directly analogous to the ERC-20 standard in Ethereum, providing deterministic balance mappings, cryptographic transfers, allowance approvals, and burn events.

Unlike EVM chains burdened by volatile gas spikes, CW20 tokens on LUXA settle within ~1.5 seconds with predictable, sub-cent execution fees powered by CometBFT consensus.

When creating a token in the LUXA IDE, creators choose between two economic policies:

• Fixed Supply (Recommended): The initial supply (e.g. 1,000,000 MOJO) is minted at instantiation and the minting capability is permanently sealed (mint: null). No party—not even the original creator—can ever print additional tokens. This eliminates inflation and prevents rug-pull risks.
• Mintable: The contract establishes an authorized minter address (mint: { minter: "luxa1..." }). This allows the designated administrator to execute subsequent minting actions on the same contract to expand supply if project milestones warrant it.

Exclusively the single cryptographic address registered as the minter!

No outside user or third party can mint tokens. Every execution message submitted to the contract verifies the cryptographic signature of the caller against the stored minter state. If any other address attempts to call mint, the CosmWasm virtual machine rejects the transaction with an immediate Unauthorized error.

To increase supply later, the owner simply connects the authorized wallet to the LUXA IDE and submits a mint action specifying the additional quantity. The contract address remains unchanged.

Yes, 100% of the tokens are delivered directly to the client's wallet!

When deploying via the LUXA IDE Deploy Modal, the operator enters the client's Bech32 address (luxa1...) into the Recipient Wallet field. The deployer pays the minor network gas fee to record the contract on luxa-1, but the contract initialization assigns the entire initial balance (e.g. 1,000,000 tokens) directly to the recipient.

As soon as the transaction is confirmed, the client opens Spider Vault or the Block Explorer and sees their full token balance under their sole cryptographic control.

On the sovereign luxa-1 mainnet, Code ID #1 is the compiled WASM binary for the LuxaSwap AMM Pair (luxa_amm_pair), which is a liquidity pool contract expecting denom_a and denom_b.

If an operator mistakenly instantiates a token with Code ID #1, the blockchain creates an empty liquidity exchange rather than a CW20 asset. Subsequent queries for get_name fail, and the wallet displays 0 tokens.

The LUXA IDE now includes an Anti-Error Guardrail that detects token templates, blocks deployments attempting to use Code ID #1, and offers a 1-click automatic fix to target the CW20 base bytecode.

Network fees on LUXA are denominated in micro-LUXA (uluxa, where $1\text{ LUXA} = 10^6\text{ uluxa}$):

• Standard L1 Coin Transfers: Fixed at 200 uluxa (0.0002 LUXA) to preserve spam resistance while guaranteeing universal micro-payment viability.
• Smart Contract Instantiations: Typically between 8,000 and 15,000 uluxa (~0.008 - 0.015 LUXA) depending on payload size.

Important: Gas fees paid to the network are consumed by CometBFT validators during cryptographic computation. They are permanent, non-refundable, and non-recoverable once a transaction block is sealed.

The LUXA DEX implements an Automated Market Maker (AMM) using the invariant formula \(x \cdot y = k\):

• Pool Pairing: Pioneers deposit two assets in balanced proportion (e.g. 500 LUXA and 1,000,000 MOJO) to open or deepen a trading market.
• LP Tokens & Fee Sharing: Depositors receive LP shares. Every trade through the pool levies a 0.3% protocol fee that is distributed pro-rata to all active liquidity providers.
• LP Yield Staking: LP tokens can be staked in yield contracts to earn boosted staking rewards paid directly from protocol reserves.

The burn action allows any holder to permanently destroy a portion of their token balance. When executed:

1. The tokens are deducted from the caller's balance.
2. The total_supply of the contract is permanently decreased on-chain.
3. A public burn event is broadcast to the block ledger.

In combination with a Fixed Supply token, this guarantees that circulating supply can only decrease or remain constant, establishing mathematically verifiable deflation.

Spider Vault is 100% non-custodial.

Your 12/24-word BIP-39 mnemonic seed phrase and private keys are encrypted locally on your device using AES-256-GCM with PBKDF2 (100,000 derivation rounds). Neither the LUXA foundation, the server infrastructure, nor any validator ever has access to your private credentials.

Spider Vault is available across three modalities: Android APK with native biometric protection, Chrome Extension for desktop dApps, and Web Vault at https://luxaecosystem.xyz/vault.html.

The sovereign luxa-1 mainnet is constructed on the Cosmos SDK utilizing the high-throughput CometBFT Byzantine Fault Tolerant consensus engine:

• Block Time: ~1.5 to 2.0 seconds with single-slot deterministic finality (zero probabilistic reorganizations).
• RPC Endpoint: https://rpc.luxaecosystem.xyz (Port 26657)
• REST API Endpoint: https://api.luxaecosystem.xyz (Port 1317)
• Explorer: https://luxaecosystem.xyz/explorer.html

The LUXA IDE features an integrated, interactive Smart Contract Console modeled after Ethereum's Remix, fully optimized for CosmWasm on luxa-1:

• Read Contract (Queries in Blue): Run instantaneous zero-gas queries against the live chain. Quick presets include token_info, balance_of, minter, allowance, and reserves, as well as arbitrary custom JSON queries.
• Write Contract (Executions in Amber): Connects directly with your active LUXA Vault (Spider's Nest). You can invoke mint (restricted to the owner/minter), transfer, burn, or custom execution payloads with signed on-chain broadcast.
• At Address (Load Any Existing Contract): Paste any valid luxa1... contract address to inspect and interact with it immediately, without needing to recompile the original source code.

Deployed contract management operates on a dual-tier architecture:

1. Browser Cache (Fast Workspace Restore): Your list of deployed and loaded contracts is automatically stored in your browser's local storage under the key luxa_ide_contracts. When you revisit the IDE on the same device, your contracts and custom labels are restored instantly.
2. On-Chain Ledger (Permanent & Immutable): The contract itself, its balances, state models, and bytecode live permanently on the luxa-1 blockchain at its Bech32 address (luxa1...).

If you clear your browser cache or change computers: Your contract on the blockchain is 100% safe! Simply paste its address into the "At Address" bar in the IDE Console or search it on the LUXA Block Explorer to regain immediate interactive access.

No external EVM chains or third-party tools are needed. You operate 100% natively on the sovereign luxa-1 Layer 1 network:

• LUXA IDE replaces Remix: Compiles LX smart contracts to CosmWasm and EVM, detects contract types, and provides a full deployment and interaction suite.
• LUXA Vault replaces MetaMask: Serves as your sovereign Web3 wallet provider, signing CosmWasm messages and managing gas in native uluxa.
• LUXA Block Explorer replaces BscScan / Etherscan: Automatically decodes contract state, provides real-time Read/Write Web3 tabs, and displays token distribution.

When searching any contract address on the LUXA Block Explorer (e.g. luxa14hj2...), the system automatically displays 5 dedicated tabs:

• 1. Transactions: Complete on-chain history of executions, blocks, and gas usage.
• 2. Read Contract: Direct querying against the luxa-1 REST node to check token_info, balances, minter, allowances, and custom queries for free.
• 3. Write Contract (Web3): Connects your LUXA Vault to execute authenticated methods (such as mint or transfer) directly from the explorer interface.
• 4. Contract Code & State: Code ID verification, deployment anchor, and an on-demand viewer for raw key-value storage models.
• 5. Token Telemetry & Holders: Total supply, token decimals, and circulating distribution with quick links to trade on LUXA Swap.

Assolutamente sì! L'ecosistema LUXA include un motore DEX e di telemetria completo:

• Selettore Token & Import CW20: Nella pagina LUXA Swap, cliccando sul selettore di token puoi cercare per nome/simbolo o incollare direttamente l'indirizzo del contratto (luxa1...). L'interfaccia interroga la blockchain in tempo reale, risolve nome, simbolo e decimali, recupera il tuo saldo e consente lo swap immediato.
• Metriche Stile CoinGecko: Nella scheda Market Overview e su Currencies, puoi visualizzare per ogni token (LUXA, SHARD o qualsiasi token custom importato): Market Cap, Fully Diluted Valuation (FDV), Volume 24h, rapporto Volume/Market Cap, indicatore di Circulating Supply, range 24h (Min/Max) e un grafico interattivo multi-intervallo (1h, 24h, 7d, 14d, 30d, 90d, 1y, ALL) con ispezione a passaggio del mouse.
• Motore Telemetrico Python: È disponibile anche lo script scripts/token_metrics_engine.py che scansiona la blockchain luxa-1 e genera feed JSON conformi allo standard CoinGecko.