Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Skill for AI agents to setup the Potato Tipper on a Universal Profile on LUKSO (requires private key), and learn to build innovative tip-on-follow solutions.
Skill for AI agents to setup the Potato Tipper on a Universal Profile on LUKSO (requires private key), and learn to build innovative tip-on-follow solutions.
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
Use this skill for anything technical around the Potato Tipper contracts repo: π reading/understanding the Potato Tipper protocol βοΈ setup + configure the Potato Tipper on your Universal Profile on LUKSO UP configuration β permissions troubleshooting when setting up π‘building new tipping systems using ideas from the Potato Tipper
The Potato Tipper protocol is an LSP1 Universal Receiver Delegate on LUKSO that automatically tips $POTATO tokens to new followers. PotatoTipper is an LSP1 Universal Receiver Delegate that reacts to LSP26 follow/unfollow notifications and transfers LSP7 $POTATO tokens from the followed user's π to the new follower π (when eligible). Per-user settings live in ERC725Y storage under a dedicated data key, and the contract provides self-documenting helper views for config keys.
Understand architecture and LUKSO/LSP integrations (LSP1, LSP7, LSP26, ERC725Y) similar to the Potato Tipper Be aware of security and known limitations with this pattern Configure a Universal Profile with the required permissions and data keys Learn to build innovative integrations using the tip-on-follow pattern. Includes TypeScript (wagmi/viem/ethers + erc725.js) and Solidity code examples.
See references/addresses.md for all contract addresses on LUKSO Mainnet and Testnet (PotatoTipper, $POTATO token, LSP26 registry, RPC endpoints, explorers).
Read references/repo-overview.md for the file map + contract responsibilities.
This uses a Foundry script that performs the full setup in a single batchCalls transaction. Step 1: Create the file script/SetupPotatoTipper.s.sol inside the Potato Tipper contracts repo: // SPDX-License-Identifier: Apache-2.0 pragma solidity ^0.8.28; import {Script} from "forge-std/Script.sol"; import {console2} from "forge-std/console2.sol"; interface ILSP0 { function batchCalls(uint256[] calldata values, bytes[] calldata payloads) external returns (bytes[] memory); } interface IERC725Y { function setDataBatch(bytes32[] calldata keys, bytes[] calldata values) external; } interface ILSP7 { function authorizeOperator(address operator, uint256 amount, bytes calldata data) external; } /// @title Setup PotatoTipper via LSP0 batchCalls /// @notice One-click setup: connect PotatoTipper + set settings + authorize budget /// @dev Run with: forge script script/SetupPotatoTipper.s.sol:SetupPotatoTipper --rpc-url <rpc> --broadcast /// /// Required env vars: /// - PRIVATE_KEY: EOA controller key (must have ADDUNIVERSALRECEIVERDELEGATE + CALL permissions on UP) /// - UP_ADDRESS: Universal Profile address to configure /// - POTATO_TIPPER_ADDRESS: PotatoTipper contract address /// - POTATO_TOKEN_ADDRESS: $POTATO LSP7 token address /// - TIP_AMOUNT: Amount to tip per follower (in wei, e.g., "1000000000000000000" = 1 POTATO) /// - MIN_FOLLOWERS: Minimum follower count for eligibility (e.g., "5") /// - MIN_POTATO_BALANCE: Minimum POTATO balance for eligibility (in wei, e.g., "100000000000000000000" = 100 POTATO) /// - TIPPING_BUDGET: Total POTATO authorized for tipping (in wei, e.g., "1000000000000000000000" = 1000 POTATO) contract SetupPotatoTipper is Script { bytes32 constant LSP1DELEGATE_ON_FOLLOW_DATA_KEY = 0x0cfc51aec37c55a4d0b1000071e02f9f05bcd5816ec4f3134aa2e5a916669537; bytes32 constant LSP1DELEGATE_ON_UNFOLLOW_DATA_KEY = 0x0cfc51aec37c55a4d0b100009d3c0b4012b69658977b099bdaa51eff0f0460f4; bytes32 constant POTATO_TIPPER_SETTINGS_KEY = 0xd1d57abed02d4c2d7ce00000e8211998bb257be214c7b0997830cd295066cc6a; function run() external { address upAddress = vm.envAddress("UP_ADDRESS"); address potatoTipperAddress = vm.envAddress("POTATO_TIPPER_ADDRESS"); address potatoTokenAddress = vm.envAddress("POTATO_TOKEN_ADDRESS"); uint256 tipAmount = vm.envUint("TIP_AMOUNT"); uint256 minFollowers = vm.envUint("MIN_FOLLOWERS"); uint256 minPotatoBalance = vm.envUint("MIN_POTATO_BALANCE"); uint256 tippingBudget = vm.envUint("TIPPING_BUDGET"); console2.log("=== PotatoTipper Setup ==="); console2.log("UP Address:", upAddress); console2.log("PotatoTipper:", potatoTipperAddress); console2.log("POTATO Token:", potatoTokenAddress); console2.log("Tip Amount (wei):", tipAmount); console2.log("Min Followers:", minFollowers); console2.log("Min POTATO Balance (wei):", minPotatoBalance); console2.log("Tipping Budget (wei):", tippingBudget); console2.log(""); bytes32[] memory dataKeys = new bytes32[](3); dataKeys[0] = POTATO_TIPPER_SETTINGS_KEY; dataKeys[1] = LSP1DELEGATE_ON_FOLLOW_DATA_KEY; dataKeys[2] = LSP1DELEGATE_ON_UNFOLLOW_DATA_KEY; bytes[] memory dataValues = new bytes[](3); dataValues[0] = abi.encode(tipAmount, minFollowers, minPotatoBalance); dataValues[1] = abi.encodePacked(potatoTipperAddress); dataValues[2] = abi.encodePacked(potatoTipperAddress); bytes[] memory payloads = new bytes[](2); payloads[0] = abi.encodeCall(IERC725Y.setDataBatch, (dataKeys, dataValues)); bytes memory authorizeCalldata = abi.encodeCall( ILSP7.authorizeOperator, (potatoTipperAddress, tippingBudget, "") ); payloads[1] = abi.encodeWithSignature( "execute(uint256,address,uint256,bytes)", 0, potatoTokenAddress, 0, authorizeCalldata ); uint256[] memory values = new uint256[](2); values[0] = 0; values[1] = 0; vm.startBroadcast(vm.envUint("PRIVATE_KEY")); console2.log("Broadcasting batchCalls to UP..."); ILSP0(upAddress).batchCalls(values, payloads); vm.stopBroadcast(); console2.log(""); console2.log("=== Setup Complete ==="); console2.log("PotatoTipper is now connected to the UP!"); console2.log("Settings configured:"); console2.log(" - Tip amount:", tipAmount, "wei"); console2.log(" - Min followers:", minFollowers); console2.log(" - Min POTATO balance:", minPotatoBalance, "wei"); console2.log("Tipping budget authorized:", tippingBudget, "wei"); } } Step 2: Run the setup via the shell wrapper: TIP_AMOUNT=42000000000000000000 \ MIN_FOLLOWERS=5 \ MIN_POTATO_BALANCE=100000000000000000000 \ TIPPING_BUDGET=1000000000000000000000 \ PRIVATE_KEY=0x... \ ./skills/potato-tipper/scripts/setup_potato_tipper.sh luksoTestnet 0xYourUPAddress This single transaction: Connects LSP1 delegates (follow + unfollow) Sets tip settings Authorizes tipping budget Manual setup details: references/config-and-data-keys.md Script implementation: references/foundry-batch-setup.md
To connect: controller needs ADDUNIVERSALRECEIVERDELEGATE permission To disconnect: controller needs CHANGEUNIVERSALRECEIVERDELEGATE permission If setup fails with a permission error, this is the most likely cause Full troubleshooting + UP Browser Extension steps: references/permissions.md
A smart contract MUST implement the LSP1UniversalReceiver interface (and report _INTERFACEID_LSP0 via ERC165) to be eligible to receive tips. The PotatoTipper checks supportsInterface(_INTERFACEID_LSP0) on the follower address and rejects EOAs. When the $POTATO token transfer happens, it calls universalReceiver(...) on both sender and recipient π. If the recipient contract does not implement LSP1, the transfer reverts (caught by the PotatoTipper's try/catch).
Full examples for encoding data keys, connecting/disconnecting from a dApp, and setting tip settings: β references/typescript-examples.md
Setting up PotatoTipper for a π from a smart contract Implementing LSP1 to receive tips in a custom contract Using loadTipSettingsRaw + decodeTipSettings free functions from any contract β references/solidity-examples.md
Only π (LSP0) followers are eligible (EOAs rejected). Follow/unfollow calls MUST come from the LSP26 Follower Registry β contract re-validates registry state. Uses try/catch around LSP7 transfers β returns user-friendly status messages, never reverts. "Existing followers" (before installation) are deliberately excluded from tips. Settings values (tipAmount, minimumPotatoBalance) are in wei (18 decimals).
Tip-on-Follow hook pattern + self-documenting ERC725Y config: references/learn-notes.md Expansion ideas (NFT badges, tiered rewards, cross-protocol composability, marketing primitives): references/innovative-integrations.md Followβtip event order (debugging): references/event-flow.md One-click setup / batching notes: references/foundry-batch-setup.md Security posture + known limitations: references/security-and-limitations.md
repo-overview.md β file map + contract responsibilities addresses.md β deployed addresses on Mainnet + Testnet config-and-data-keys.md β the 3 config keys + encoding/decoding permissions.md β required LSP6 permissions (ADD/CHANGE UNIVERSALRECEIVERDELEGATE) typescript-examples.md β wagmi, viem, ethers + erc725.js code solidity-examples.md β setup contract, LSP1 receiver, settings reader learn-notes.md β design patterns (Tip-on-Follow + self-documenting config) innovative-integrations.md β expansion ideas for new integrations event-flow.md β followβtip event emission order (debug) foundry-batch-setup.md β batching / one-click setup notes security-and-limitations.md β known limitations + security design
setup_potato_tipper.sh β shell wrapper that clones the repo + runs the Foundry setup script
assets/abis/UniversalProfile.abi.json β minimal UP ABI for setData/setDataBatch + reads assets/abis/LSP7DigitalAsset.abi.json β minimal LSP7 ABI incl. authorizeOperator assets/abis/PotatoTipper.abi.json β minimal PotatoTipper ABI (events + a few views) assets/abis/KeyManager.abi.json β minimal KeyManager ABI (execute/executeBatch)
Agent frameworks, memory systems, reasoning layers, and model-native orchestration.
Largest current source with strong distribution and engagement signals.