Testnet paymaster feature update

[pritulsingh]

🚀 Feature Request: Add Testnet Support (Sepolia)

Problem

Currently, the AgentKit only supports mainnet chains, which makes it risky and expensive for developers to test their integrations. Testing with real tokens creates barriers for new users and makes development harder.

Proposed Solution

Add Sepolia testnet support with a feature flag system, allowing developers to safely test gasless transactions with test tokens that have no real value.

Benefits

• Safe testing environment without real money
• Better onboarding for new developers
• Foundation for adding more testnets later

Implementation Approach

I can contribute the code changes needed:

What I can implement:

• Feature flag system (TESTNET_SUPPORT=true/false)
• Sepolia chain integration using existing viem/chains
• Environment-based token address configuration
• TypeScript support and proper error handling

What maintainers need to do:

• Deploy smart contracts (Paymaster, Account Factory) on Sepolia
• Set up environment variables for contract addresses
• Fund the paymaster with test ETH

Technical Details

The implementation uses feature flags to conditionally include Sepolia:

export const TESTNET_SUPPORT = process.env.TESTNET_SUPPORT === 'true' || process.env.NODE_ENV === 'development';

export const supportedChains = {
  // existing mainnet chains...
  ...(TESTNET_SUPPORT && {
    11155111: sepolia,
  })
};

All testnet functionality is disabled by default and only enabled when the flag is set.

Next Steps

If this sounds good, I can:

1. Create a pull request with the code changes
2. Provide documentation for deploying the required infrastructure
3. Help test the implementation

The changes are backwards compatible and won't affect existing mainnet functionality.

@Adi-21 could you please review this PR?

[Adi-21]

Yes, sure I will check and review it and let you know in the comment of the PR. Thank you, Regards

…

On Sat, Aug 23, 2025, 11:52 AM PRITUL SINGH ***@***.***> wrote: 🚀 Feature Request: Add Testnet Support (Sepolia) Problem Currently, the AgentKit only supports mainnet chains, which makes it risky and expensive for developers to test their integrations. Testing with real tokens creates barriers for new users and makes development harder. Proposed Solution Add Sepolia testnet support with a feature flag system, allowing developers to safely test gasless transactions with test tokens that have no real value. Benefits - Safe testing environment without real money - Better onboarding for new developers - Foundation for adding more testnets later Implementation Approach I can contribute the code changes needed: What I can implement: - Feature flag system (TESTNET_SUPPORT=true/false) - Sepolia chain integration using existing viem/chains - Environment-based token address configuration - TypeScript support and proper error handling What maintainers need to do: - Deploy smart contracts (Paymaster, Account Factory) on Sepolia - Set up environment variables for contract addresses - Fund the paymaster with test ETH Technical Details The implementation uses feature flags to conditionally include Sepolia: export const TESTNET_SUPPORT = process.env.TESTNET_SUPPORT === 'true' || process.env.NODE_ENV === 'development'; export const supportedChains = { // existing mainnet chains... ...(TESTNET_SUPPORT && { 11155111: sepolia, })}; All testnet functionality is disabled by default and only enabled when the flag is set. Next Steps If this sounds good, I can: 1. Create a pull request with the code changes 2. Provide documentation for deploying the required infrastructure 3. Help test the implementation The changes are backwards compatible and won't affect existing mainnet functionality. @Adi-21 <https://github.com/Adi-21> could you please review this PR? ------------------------------ You can view, comment on, or merge this pull request online at: #18 Commit Summary - 4f35411 <4f35411> Testnet feature update File Changes (4 files <https://github.com/0xgasless/agentkit/pull/18/files>) - *M* agentkit-core/src/actions/disperseAction_test.ts <https://github.com/0xgasless/agentkit/pull/18/files#diff-f517a7846b991a615428405a5c5d0fc15bbc2bd8009f6cf794e1402076cd209a> (67) - *M* agentkit-core/src/constants.ts <https://github.com/0xgasless/agentkit/pull/18/files#diff-9c6dcd29c3e0b259d05f2f3b9738c3a9093d903f1d6c77df3f3be8c189738508> (208) - *A* agentkit-core/src/utils/validation.ts <https://github.com/0xgasless/agentkit/pull/18/files#diff-215655cbd60e463c80124a49c49db7dc625ed4065fab9ed1213049de209af9ab> (64) - *M* agentkit-demo/.env.sample <https://github.com/0xgasless/agentkit/pull/18/files#diff-5c037133a178476327669b5c1bbf1f0df4dab1684ca9c89f99a440b61e9d1c63> (46) Patch Links: - https://github.com/0xgasless/agentkit/pull/18.patch - https://github.com/0xgasless/agentkit/pull/18.diff — Reply to this email directly, view it on GitHub <#18>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/ASNU3VXQDLIBQXB32DC3YAT3PACCBAVCNFSM6AAAAACETU3NNWVHI2DSMVQWIX3LMV43ASLTON2WKOZTGM2DONJTGE3DQNY> . You are receiving this because you were mentioned.Message ID: ***@***.***>