AuResources

List Sale Contracts

[Step 1 of 5] Discover all AuResources PGF gold token sale contracts from the factory. Returns on-chain metadata for each sale: address, name, active/paused status, start/end dates, soft and hard cap (USD), minimum ticket (USD), current Chainlink spot gold price, discount percentage, and effective discounted gold price. PGF tokens are sold at a discount of 12.5%–17.5% to the live Chainlink spot gold price. Always call this first — the returned contractAddress is required by all other tools. Filt

Get Supported Currencies

[Step 2 of 5] Return the active ERC-20 currencies accepted by a sale contract. Returns an array of { address, symbol, decimals, destinationCurrency, destinationDecimals }. symbol is the human-readable token name (e.g. USDC, USDT, DAI) — use it to present options to the user. Pass the sourceCurrency address and decimals to get_sale_quote. Requires a contractAddress from list_sale_contracts.

Get Sale Quote

[Step 3 of 5] Fetch a live price quote from a sale contract. Provide amountIn (input spend, e.g. "100") OR amountOut (desired PGF token quantity) — not both. Returns amountInRaw (raw units for approve/newSale), quotePricePerToken, quoteSlippage, and estimatedTokensOut. WARNING: Quotes expire within seconds — call build_new_sale_tx immediately after this tool.

Build Approve Transaction

[Step 4 of 5] Check ERC-20 allowance and build an unsigned approve transaction if needed. Returns { approvalNeeded: false } if the contract already has sufficient allowance. Returns { approvalNeeded: true, transaction } with unsigned calldata if approval is needed. The agent must sign, broadcast, and wait for the approve tx to be confirmed before step 5. This tool only builds a transaction — it does NOT submit anything to the network.

Build New Sale Transaction

[Step 5 of 5] Build an unsigned newSale transaction to purchase PGF tokens. Pass amountInRaw, quotePricePerToken, and quoteSlippage directly from get_sale_quote output. Returns a transaction payload { to, data, value, chainId, gasEstimate } ready for signing. Prerequisites: approval tx must be confirmed (step 4) and the quote must be fresh (step 3). This tool only builds a transaction — it does NOT submit anything to the network.

Check ERC-20 Balance

Check the ERC-20 token balance of a wallet address on Polygon. Use this to verify the user has sufficient supported currency (USDC, USDT, DAI) before proceeding with a purchase. Also use this in the wallet preparation flow to check if the wallet is funded. Returns symbol, decimals, rawBalance, and humanBalance. Pass the tokenAddress from get_supported_currencies output.

Get PGF Token Balance

Return the PGF gold token balance of a wallet after a purchase. Auto-discovers the PGF token contract address from the sale contract's destination currency — no need to know the token address. Call this after a successful newSale transaction to confirm the user received their PGF tokens. Provide contractAddress (from list_sale_contracts) to specify which sale to derive the PGF token from, or omit to auto-discover from the first contract in the factory.

Get Sale Progress

Return live status for a PGF token sale contract. Returns isOpen (computed from active, paused, and current time vs sale window), start/end dates, timeRemainingSeconds, and soft/hard cap amounts in USD. Call this alongside list_sale_contracts to convey urgency to the buyer (time remaining, proximity to hard cap). Requires a contractAddress from list_sale_contracts.

Check Transaction Status

Check the status of a submitted transaction on Polygon by its hash. Returns status (success, failed, pending), blockNumber, gasUsed, and block timestamp. Use this after submitting a signed approve or newSale transaction to confirm it was mined.