# Guides

At time of launch, Simulacrum lets you perform onchain actions directly from X (Twitter) using simple commands. Each command starts with a hashtag and follows a specific format.

**Coming soon:** LLM integration, so you can use natural language to execute onchain actions!

### Quick Start Example

```
#simu #tip 0.0002 ETH @username
```

This command tips 0.0002 ETH to the specified user. **All commands must begin with #simu**

### Available Commands

#### 📝 Attest

Put a simple message on-chain (fixed length).

<pre><code><strong>#simu #attest [your message]
</strong></code></pre>

<figure><img src="https://3147612106-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRTDiCNWNhWcdy6MJQR2X%2Fuploads%2FfwkSS4Bf6HyUInqjGg8s%2Fattest.png?alt=media&#x26;token=a19af3a4-2aac-4276-bf4c-53786bfd1dbb" alt=""><figcaption></figcaption></figure>

#### 📛 Register Basename

Register your unique Basename on-chain.

```
#simu #basenames #register [basename] [@username]
```

* `@username` is optional. If omitted, mints to your wallet Example:\
  &#x20;`#simulacrum #basenames #register simulacrum1`

<figure><img src="https://3147612106-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRTDiCNWNhWcdy6MJQR2X%2Fuploads%2FS3JYwjMK9c6x0VttEif2%2Fbasename.png?alt=media&#x26;token=1efc6cd0-c399-4613-82af-83a2c3b01592" alt=""><figcaption></figcaption></figure>

#### 💱 Swap Tokens

Trade between tokens. Keep it simple - no additional text after the command.

Basic commands:

```
#simu #buy [amount in eth] [contract address]
#simu #sell [Percentage] [Contract Address]
```

e.g. #simu #sell 3% 0x161e113B8E9BBAEfb846F73F31624F6f9607bd44 would sell 3% of your $SIMMI balance

<figure><img src="https://3147612106-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRTDiCNWNhWcdy6MJQR2X%2Fuploads%2FN3DRJFoASdlwez8kH5kD%2FScreenshot%202024-12-04%20at%2012.33.40%E2%80%AFPM.png?alt=media&#x26;token=7cbe9e65-6dfa-42f9-8c65-01cb8695c104" alt=""><figcaption></figcaption></figure>

## 💸 Tip

Send tokens to another user.

<pre><code><strong>#simu #tip [amount] [token] [@recipient]
</strong></code></pre>

* `token` is optional (defaults to ETH) Example: `#simu #tip 0.0002 @username`&#x20;
* `recipient` can be a twitter username, or a wallet address

<figure><img src="https://3147612106-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRTDiCNWNhWcdy6MJQR2X%2Fuploads%2FEAQsCKYEBCGlQB87ORGt%2Ftip.png?alt=media&#x26;token=34291fd0-3759-44a3-a465-bf775e766abc" alt=""><figcaption></figcaption></figure>

#### 🔄 Token Operations

**Transfer tokens:**

```
#simu #token #transfer [token] [@recipient] [amount]
```

* `token` is optional (defaults to ETH)

<figure><img src="https://3147612106-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRTDiCNWNhWcdy6MJQR2X%2Fuploads%2Frl1zBUOxJLTmGSDa7OtF%2Ftransfer.png?alt=media&#x26;token=b06d6ee5-d197-4e4e-8ddd-3ac42f724d74" alt=""><figcaption></figcaption></figure>

**Approve token spending:**

```
#simu #token #approve [token] [spender] [amount]
```

* Allows another address to spend tokens on your behalf
* Use this before certain DeFi operations

**Burn tokens:**

```
#simu #burn [percentage of your balance] [contract address]
```

<figure><img src="https://3147612106-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRTDiCNWNhWcdy6MJQR2X%2Fuploads%2FScHsVGfQ1k09BQTJZLQU%2FScreenshot%202024-12-04%20at%2012.34.51%E2%80%AFPM.png?alt=media&#x26;token=c8fe226b-2b80-4553-9542-32ba0a915673" alt=""><figcaption></figcaption></figure>

* % is percentage of tokens held in the wallet to be burned.

### Best Practices

1. Double-check all addresses and amounts before sending
2. For swap commands, avoid adding any extra text
3. Use ETH as the default token when possible for simpler commands
4. Make sure you have sufficient balance and gas fees
