# Earn

## Overview

Earn vaults put deposited assets into a yield venue and issue Earn shares that represent the
position. The asset value of those shares can change as the venue earns yield and the vault accrues
fees.

Each action takes a vault address. Use
[`earn.getVault`](/tempo/actions/earn.getVault) to inspect its asset token, current venue integration,
state, and supported actions before depositing.

:::code-group
```ts twoslash [example.ts]
import { client } from './viem.config'

const vault = await client.earn.getVault({
  vault: '0x0000000000000000000000000000000000000001',
})
// @log: {
// @log:   assetToken: '0x20c0...0001',
// @log:   capabilities: { exactWithdraw: true, inKindDeposit: true, syncRedeem: true, ... },
// @log:   depositsPaused: false,
// @log:   shareToken: '0x20c0...0002',
// @log:   ...
// @log: }
```

```ts twoslash [viem.config.ts] filename="viem.config.ts"
// [!include ~/snippets/tempo/viem.config.ts:setup]
```
:::

Assets are the TIP-20 tokens accepted by a vault. Earn shares are TIP-20 tokens representing a
proportional claim on the vault's assets. Venue shares are positions held by the vault in its
underlying yield venue.

<Cards>
  <Card icon="lucide:circle-dollar-sign" title="Deposit & Withdraw" description="Enter an Earn vault, inspect a position, and choose an exit shape." to="/tempo/guides/earn/deposit-withdraw" />

  <Card icon="lucide:shield-check" title="Protected Vaults" description="Restrict who can receive Earn shares without freezing existing positions." to="/tempo/guides/earn/protected-vaults" />

  <Card icon="lucide:lock-keyhole" title="Earn with Private Zones" description="Deposit into and redeem from a vault through a private Zone." to="/tempo/guides/earn/zones" />

  <Card icon="lucide:landmark" title="Inspect a Vault" description="Read vault configuration, accounting state, and supported actions." to="/tempo/actions/earn.getVault" />

  <Card icon="lucide:wallet-cards" title="Inspect a Position" description="Read asset and Earn share balances, allowances, and current value." to="/tempo/actions/earn.getPosition" />

  <Card icon="lucide:square-function" title="Earn Actions" description="Browse the complete earn action reference." to="/tempo/actions/earn.deposit" />
</Cards>