> For the complete documentation index, see [llms.txt](https://tilepmoney.gitbook.io/tilepmoney-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tilepmoney.gitbook.io/tilepmoney-docs/guides/troubleshooting.md). # Troubleshooting Common issues and solutions when using TilepMoney. ### Common Issues #### Wallet Connection Problems **Issue:** Cannot connect wallet to Mantle testnet **Solutions:** 1. Ensure Mantle testnet is added to your wallet: * Network Name: Mantle Testnet * RPC URL: `https://rpc.testnet.mantle.xyz` * Chain ID: 5003 * Currency Symbol: MNT * Block Explorer: `https://explorer.testnet.mantle.xyz` 2. Check wallet extension is enabled and unlocked 3. Try disconnecting and reconnecting 4. Clear browser cache and reload **Issue:** Wallet connected but transactions fail **Solutions:** 1. Ensure you have testnet MNT for gas fees 2. Check network is set to Mantle Testnet 3. Verify wallet has sufficient balance 4. Try increasing gas limit in wallet settings *** #### Workflow Execution Errors **Issue:** Workflow execution fails immediately **Solutions:** 1. Check workflow validation: * All nodes properly connected * No circular dependencies * All required fields filled * Valid wallet addresses 2. Verify wallet connection 3. Check sufficient balance for operations 4. Review error message in execution log **Issue:** Specific node fails during execution **Solutions:** 1. Check node configuration: * Valid amounts * Correct token types * Valid addresses 2. Verify sufficient balance for that operation 3. Check gas fees are available 4. Review transaction hash on block explorer **Issue:** Transaction stuck pending **Solutions:** 1. Check Mantle testnet status 2. Verify RPC connection 3. Try increasing gas price 4. Wait for network congestion to clear *** #### Database Connection Issues **Issue:** Cannot save workflows **Solutions:** 1. Check MongoDB connection string in `.env.local` 2. Verify MongoDB Atlas IP whitelist includes your IP 3. Check MongoDB cluster is running 4. Verify network connectivity **Issue:** Workflows not loading **Solutions:** 1. Check database connection 2. Verify user authentication 3. Check browser console for errors 4. Try refreshing the page *** #### Build and Development Issues **Issue:** `pnpm install` fails **Solutions:** 1. Clear cache: `pnpm store prune` 2. Delete `node_modules` and `pnpm-lock.yaml` 3. Try again: `pnpm install` 4. Check Node.js version (requires 20+) **Issue:** Development server won't start **Solutions:** 1. Check port 3000 is available: ```bash lsof -ti:3000 | xargs kill -9 ``` 2. Verify environment variables are set 3. Check MongoDB connection 4. Review error messages in terminal **Issue:** TypeScript errors **Solutions:** 1. Run type checking: `pnpm typecheck` 2. Check for missing dependencies 3. Verify TypeScript version 4. Clear `.next` folder and rebuild *** #### Smart Contract Issues **Issue:** Contract calls failing **Solutions:** 1. Verify contract addresses are correct 2. Check contract is deployed on Mantle testnet 3. Verify function parameters are correct 4. Check contract has required permissions **Issue:** Gas estimation fails **Solutions:** 1. Check RPC connection 2. Verify contract exists at address 3. Check function parameters are valid 4. Try manual gas limit *** ### Frequently Asked Questions #### General Questions **Q: What is TilepMoney?** A: TilepMoney is a codeless stablecoin orchestration builder for B2B payments infrastructure. It enables businesses to visually design and automate stablecoin payment workflows. **Q: Do I need to know how to code?** A: No! TilepMoney is designed to be codeless. You can create workflows using the visual drag-and-drop interface. **Q: Is TilepMoney free to use?** A: Currently, TilepMoney is available for testing on Mantle testnet. Production pricing will be announced later. **Q: What networks does TilepMoney support?** A: Currently, TilepMoney supports Mantle testnet. Mainnet support is planned for the future. *** #### Workflow Questions **Q: How many nodes can I have in a workflow?** A: There's no hard limit, but we recommend keeping workflows manageable (under 20 nodes) for better performance. **Q: Can I edit a workflow while it's running?** A: No, workflows cannot be edited while executing. You must stop the execution first. **Q: Can I pause and resume workflow execution?** A: Currently, workflows run to completion once started. Pause/resume functionality is planned for future releases. **Q: What happens if a node fails?** A: Execution stops at the failed node. You can review the error, fix the issue, and retry from that node. **Q: Can I duplicate workflows?** A: Yes! Use the "Duplicate" button on the workflow dashboard to create a copy. *** #### Node Questions **Q: What's the difference between Mint and Swap?** A: Mint converts fiat (IDR/USD) to stablecoin. Swap exchanges one token for another (e.g., IDRX to USDT). **Q: Can I use real fiat currencies?** A: Currently, TilepMoney uses dummy tokens and simulated fiat on testnet. Real fiat integration is planned for production. **Q: How do Vault stop conditions work?** A: Vault nodes monitor conditions (target amount, time, APR) and automatically execute withdrawal when conditions are met. **Q: Can Partition nodes have more than 5 branches?** A: No, Partition nodes support 2-5 branches maximum. For more branches, use multiple Partition nodes. *** #### Technical Questions **Q: What blockchain does TilepMoney use?** A: TilepMoney is built for Mantle Network, an Ethereum Layer 2 solution. **Q: Are smart contracts audited?** A: Smart contracts are currently on testnet. Audits will be conducted before mainnet deployment. **Q: How is data stored?** A: Workflow data is stored in MongoDB. Transaction data is on-chain on Mantle testnet. **Q: Is my wallet secure?** A: TilepMoney uses Privy for wallet authentication. Your private keys never leave your wallet. **Q: Can I use my own RPC endpoint?** A: Yes, configure your RPC URL in environment variables. *** #### Integration Questions **Q: Can I integrate TilepMoney with my backend?** A: Yes! TilepMoney provides RESTful API endpoints for backend integration. See API Reference. **Q: Are there webhooks?** A: Webhooks are planned for future releases. Currently, use polling or the API to check status. **Q: Can I export workflow data?** A: Yes, workflows can be exported as JSON from the dashboard. **Q: Is there a mobile app?** A: Currently, TilepMoney is web-only. Mobile support is planned for the future. *** --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://tilepmoney.gitbook.io/tilepmoney-docs/guides/troubleshooting.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.