potato-tipper

# Potato Tipper - OpenClaw Skill

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

## What it is (1-paragraph mental model)

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.

## What this skill provides

- 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.

## Deployed addresses

See `references/addresses.md` for all contract addresses on LUKSO Mainnet and Testnet (PotatoTipper, $POTATO token, LSP26 registry, RPC endpoints, explorers).

## Quick workflows

### 1) Get oriented (repo map)

Read `references/repo-overview.md` for the file map + contract responsibilities.

### 2) Configure a user's 🆙 to use PotatoTipper (one-click)

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:

```solidity
// SPDX-License-Identifier: Apache-2.0
pragma solid...

# Potato Tipper - OpenClaw Skill

An OpenClaw skill for AI agents to work with the **Potato Tipper** protocol — an LSP1 Universal Receiver Delegate on LUKSO that automatically tips $POTATO tokens to new followers.

## Source Repository

> See the [**Potato Tipper contracts** on GitHub](https://github.com/CJ42/potato-tipper-contracts)

## How It Works

When someone follows a Universal Profile that has Potato Tipper installed, the follow event triggers an LSP1 notification which automatically sends $POTATO tokens from the followed user's UP to the new follower's UP. Think of it as an on-chain "welcome gift" for new followers.

```
User B follows User A (LSP26)
    → LSP1 notification hits User A's UP
    → PotatoTipper delegate activates
    → $POTATO tokens sent from User A → User B
```

## Key Concepts

- **LSP1 Universal Receiver Delegate** - Reacts to incoming LSP26 follow/unfollow events
- **LSP7 $POTATO Token** - Fungible token used for tipping
- **LSP26 Follower Registry** - On-chain social graph that triggers the tip flow
- **ERC725Y Config** - Per-user tip settings stored as data keys on their UP

## Deployed Contracts

| Contract | LUKSO Mainnet | LUKSO Testnet |
|----------|--------------|---------------|
| PotatoTipper | `0x5eed04004c2D46C12Fe30C639A90AD5d6F5D573d` | `0xB844b12313A2D702203109E9487C24aE807e1d66` |
| $POTATO Token | `0x80D898C5A3A0B118a0c8C8aDcdBB260FC687F1ce` | `0xE8280e7f0d54daE39725dC5f500F567Af2854A13` |

## Skill Structure

```
potato-tipper/
├── SKILL.md                # Main skill instructions
├── README.md               # This file
├── references/
│   ├── repo-overview.md            # File map + contract responsibilities
│   ├── addresses.md                # Deployed addresses (Mainnet + Testnet)
│   ├── config-and-data-keys.md     # ERC725Y config keys + encoding
│   ├── permissions.md              # Required LSP6 permissions
│   ├── typescript-examples.md      # wagmi, viem, ethers + erc725.js code
│   ├── solidity-examples.md...