# nice1swapper 

Introduction: **An easy way to offer swap between tokens**, valid for EOSio (antelope) blockchains.

With support of PomeloGrants

Github repo: <https://github.com/nice1-blockchain/nice1swapper/>

## Use cases

This contract offers the possibility of exchanging fungible items in video games (backed by tokens), this can be represented with several examples such as the exchange of "10 Apples for 1 apple juice" and vice versa this exchange can be executed in the game processed on the network itself.

It also offers the possibility to acquire special tokens like "fornitebuks" in web3 games in exchange for any token that is required.

As another example of use not focused on web3 gaming, it also allows the exchange of tokens for projects that wish to offer their tokens to users in exchange for other tokens on the chain.

### How it works

As a contract administrator you will be able to run an action that will allow you to configure a swap option with a unique identifier.

In this action you will be able to configure fields such as, the token contract you want to offer and the amount of tokens on one side and on the other side how many tokens you expect to receive for the amount of tokens and from which contract.

You can make different configurations with different ratios according to your needs.

> Example 1: 1EOS = 10Gold , 5EOS = 50 Gold , 10 EOS = 100 Gold\
> Example > 2: 1EOS = 10Gold , 5EOS = 60 Gold , 10 EOS = 150 Gold

Users will only need to make a standard transfer to the contract and will instantly receive the counterpart.


---

# 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.nice1.dev/smartcontracts/nice1swapper.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.