# almm:claim-reward — Ammora SDK 0.3.8

Collect what a position has earned from a pool's reward campaign. npm run almm:claim-reward -- <tokenId> [slot] The other side of `almm:create-reward`. Rewards accrue to a position for as long as it holds liquidity while a campaign runs, and this collects them without touching the liquidity itself. The position stays exactly as it was and keeps earning. ── Read before sending ─────────────────────────────────────────────────────── `previewPositionReward` reports what the position would be paid right now. It is worth asking, because a position that joined after a campaign ended, or that has already claimed, has earned nothing, and claiming nothing still costs gas. A pool can run two campaigns at once, in slots 0 and 1, paying different tokens. They accrue independently and are claimed independently, so a position in a pool running both has two claims to make. ───────────────────────────────────────────────────────────────────────────────

[Read in Docs](https://docs.ammora.org/examples?command=almm%3Aclaim-reward) · [Detailed guide](https://docs.ammora.org/guides/src-almm-readme) · [Local setup](https://docs.ammora.org/guides/example-setup)

## Context and execution

GIWA Sepolia 91342. Public SDK 0.3.8, Math 0.3.0. Source revision: `a9b3fd798fa51495e8defec99a25de59e4d70672`.
Install the SDK in your app, or prepare the example project using the local setup guide for its npm commands. Review the entry source and guide for required arguments, roles and deployment selection. `AMMORA_SEND=0` does not turn send-only commands into previews. Never put CLI keys in a browser or resend an uncertain transaction.

Command: `npm run almm:claim-reward -- <arguments from the source below>` (`tsx src/almm/claim-reward.ts`). Omit `--` and arguments when the source accepts none.

## Entry file: `src/almm/claim-reward.ts`

```typescript
/**
 * Collect what a position has earned from a pool's reward campaign.
 *
 *   npm run almm:claim-reward -- <tokenId> [slot]
 *
 * The other side of `almm:create-reward`. Rewards accrue to a position for as long as it
 * holds liquidity while a campaign runs, and this collects them without touching the
 * liquidity itself. The position stays exactly as it was and keeps earning.
 *
 * ── Read before sending ───────────────────────────────────────────────────────
 * `previewPositionReward` reports what the position would be paid right now. It
 * is worth asking, because a position that joined after a campaign ended, or that
 * has already claimed, has earned nothing, and claiming nothing still costs gas.
 *
 * A pool can run two campaigns at once, in slots 0 and 1, paying different
 * tokens. They accrue independently and are claimed independently, so a position
 * in a pool running both has two claims to make.
 * ───────────────────────────────────────────────────────────────────────────────
 */
import type { Address } from "viem";
import {
  almmPositionManagerAbi,
  almmRewardManagerAbi,
  buildClaimALMMPositionReward,
} from "@ammora-protocol/sdk";
import { deployment, reader, signer } from "../shared/env.js";
import { amount, main, positionOwner, preflight, requireContract, send, tokenInfo } from "../shared/run.js";

main(async () => {
  const [tokenArgument, slotArgument] = process.argv.slice(2);
  if (!tokenArgument || !/^\d+$/.test(tokenArgument)) {
    throw new Error("usage: npm run almm:claim-reward -- <tokenId> [slot]");
  }
  const tokenId = BigInt(tokenArgument);
  const slot = Number(slotArgument ?? 0);
  if (slot !== 0 && slot !== 1) throw new Error("slot is 0 or 1");

  const { wallet, account } = signer();
  const client = await reader();
  const contracts = deployment().contracts.liquidityMarketMaker;
  await requireContract(client, "reward manager", contracts.rewardManager);

  const owner = await positionOwner(
    client, almmPositionManagerAbi, contracts.positionManager, tokenId,
  );
  if (owner.toLowerCase() !== account.address.toLowerCase()) {
    throw new Error(`position ${tokenId} belongs to ${owner}, not to you`);
  }

  const [pool] = await client.readContract({
    abi: almmPositionManagerAbi, address: contracts.positionManager,
    functionName: "positions", args: [tokenId],
  }) as readonly [Address, number, number];

  const campaign = await client.readContract({
    abi: almmRewardManagerAbi, address: contracts.rewardManager,
    functionName: "getRewardInfo", args: [pool, slot],
  }) as { token: Address };
  if (campaign.token === "0x0000000000000000000000000000000000000000") {
    console.log(`pool ${pool} runs no campaign in slot ${slot}`);
    return;
  }

  const reward = await tokenInfo(client, campaign.token);
  const owed = await client.readContract({
    abi: almmRewardManagerAbi, address: contracts.rewardManager,
    functionName: "previewPositionReward", args: [tokenId, slot],
  }) as bigint;

  console.log(`position   ${tokenId}`);
  console.log(`pool       ${pool}`);
  console.log(`slot       ${slot} pays ${reward.symbol}`);
  console.log(`owed       ${amount(owed, reward.decimals, reward.symbol)}`);
  console.log("");

  if (owed === 0n) {
    console.log("nothing to claim, no transaction sent");
    return;
  }

  const claim = {
    to: contracts.rewardManager,
    ...buildClaimALMMPositionReward(tokenId, slot, account.address),
  };
  await preflight(client, account, claim, almmRewardManagerAbi, "claim reward");
  await send("claim reward", claim, wallet, account, client);
});
```

## Supporting files

Keep relative paths intact. Local imports are listed recursively; JSON templates are choices to review, not approved inputs. Runtime-selected files and wallet/environment setup still follow the detailed guide.

- [src/shared/env.ts](https://docs.ammora.org/examples/source/src/shared/env.ts.txt)
- [src/shared/input.ts](https://docs.ammora.org/examples/source/src/shared/input.ts.txt)
- [src/shared/retry.ts](https://docs.ammora.org/examples/source/src/shared/retry.ts.txt)
- [src/shared/rpc.ts](https://docs.ammora.org/examples/source/src/shared/rpc.ts.txt)
- [src/shared/run.ts](https://docs.ammora.org/examples/source/src/shared/run.ts.txt)
- [src/almm/rebalance.example.json](https://docs.ammora.org/examples/source/src/almm/rebalance.example.json.txt)
- [package.json](https://docs.ammora.org/examples/source/package.json.txt)
- [package-lock.json](https://docs.ammora.org/examples/source/package-lock.json.txt)
- [tsconfig.json](https://docs.ammora.org/examples/source/tsconfig.json.txt)
- [.env.giwa.example](https://docs.ammora.org/examples/source/file.env.giwa.example.txt)
- [.nvmrc](https://docs.ammora.org/examples/source/file.nvmrc.txt)

## AI implementation checklist

Use the actual SDK exports and parameter types in the linked files. Start with reads and unsigned plans where supported. Use a connected wallet for browser signing. Preserve raw integer units, exact approvals, caller authority, deadlines and receipt reconciliation. Report local checks separately from live-chain verification.