# Use SendArcade

The `Use SendArcade` tool, part of AgentiPy, allows users to interact with the Sendarcade platform (`https://rps.sendarcade.fun`), specifically to play a game of Rock Paper Scissors. The game involves staking an amount of SOL and making a choice ("rock", "paper", or "scissors"). The interaction is handled through a series of API calls to Sendarcade, which provides transaction details that are then signed and submitted to the Solana blockchain.

## Functionality

This tool is implemented in the `SendArcadeManager` class. It interacts directly with the Sendarcade API.

### Key Methods:

* `rock_paper_scissor(agent: SolanaAgentKit, amount: float, choice: str) -> str`:
  * Initiates a Rock Paper Scissors game.
  * Parameters:
    * `agent`: The `SolanaAgentKit` instance (provides wallet and connection).
    * `amount`: The amount of SOL to stake on the game.
    * `choice`: The player's choice ("rock", "paper", or "scissors").
  * Makes a POST request to the Sendarcade API (`/api/actions/bot`) with the game parameters.
  * If the API returns a transaction, it's signed by the agent's wallet and sent to the Solana network.
  * After confirmation, it calls the `outcome` method to get the game result.
  * Returns a game result message (e.g., "You lost...") or a transaction signature if a claim is needed.
* `outcome(agent: SolanaAgentKit, sig: str, href: str) -> str`:
  * (Internal helper, called by `rock_paper_scissor`) Retrieves the outcome of the game using a transaction `sig` (signature) and an API `href` (path) provided by the previous step.
  * If the game was won and a prize can be claimed, it calls `won`.
  * Returns an outcome message.
* `won(agent: SolanaAgentKit, href: str) -> str`:
  * (Internal helper) Handles the transaction process if the player won and needs to claim a prize. Uses an API `href` for claiming.
  * If a claim transaction is provided by the API, it's signed and sent.
  * May call `post_win` for a final step.
  * Returns a success/failure message for the claim.
* `post_win(agent: SolanaAgentKit, href: str) -> str`:
  * (Internal helper) Finalizes the prize claim process using an API `href`.
  * Returns a confirmation message.

##

**Important Considerations:**

* **Direct API Interaction & On-Chain:** This tool interacts directly with the Sendarcade API to get transaction details, which are then signed by the agent's wallet and submitted to the Solana blockchain. These are on-chain financial transactions (staking SOL).
* **Gaming Risk:** Playing games on such platforms involves the risk of losing the staked amount.
* **API Reliance:** The entire game flow and outcome processing depend on the Sendarcade API's responses and availability.

## Source Code

You can find the source code for this tool on GitHub: <https://github.com/niceberginc/agentipy/blob/main/agentipy/tools/use_sendarcade.py>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.agentipy.fun/tools/use-sendarcade.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.