# Use G$ streaming

**First-step:**

* Superfluid concepts: [What is Superfluid?](https://docs.superfluid.org/docs/concepts/superfluid)

***

### TL;DR (one-minute overview)

Streaming Payments with G$ Token\
GoodDollar’s G$ is deployed as a pure Superfluid SuperToken on the Celo network—no wrapping needed, so it can be streamed second-by-second out of the box.\
Streaming turns one-off transfers into continuous flows, enabling payroll, vesting, or loan payments. \
For other example use cases, see[ here.](https://docs.superfluid.org/docs/category/examples-1)\
For simple second-by-second transfers called **'streaming',** powered by the SuperFluid Protocol, you talk **directly** to the immutable **`CFAv1Forwarder`** contract (`0xcfA132E3…B125) and pass in G$’s address (`0x62B8…C7A\`).\
All flows boil down to three methods:

```solidity
createFlow(ISuperToken token, address sender, address receiver, int96 flowRate, bytes userData)
updateFlow(ISuperToken token, address sender, address receiver, int96 newRate, bytes userData)
deleteFlow(ISuperToken token, address sender, address receiver, bytes userData)
```

Optional next steps:

* **GDAv1Forwarder** → pool-style distribution streams, optimized to work with off-chain interactions. ([docs.superfluid.finance](https://docs.superfluid.finance/docs/technical-reference/GDAv1Forwarder))
* **Super-Apps** → have your contracts *react* to flow events once you register them with the Host. ([docs.superfluid.finance](https://docs.superfluid.finance/docs/concepts/advanced-topics/super-apps), [GitHub](https://github.com/superfluid-org/protocol-monorepo/wiki/About-App-Registry))

***

### Prerequisites

| What                                             | Why                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Node ≥ 18 & bundler (Vite / Next)                | To build a web client                                                                                                                                                                                                                                                                                                                                                                                                                             |
| **ethers v6** *or* **viem + wagmi**              | Low-level EVM calls                                                                                                                                                                                                                                                                                                                                                                                                                               |
| A wallet on **Celo Mainnet** (`chainId = 42220`) | Only Celo currently has G$ streaming capabilities.                                                                                                                                                                                                                                                                                                                                                                                                |
| G$ token address                                 | <p>(<strong>Recommended for testing</strong>: Development G$)<br><a href="https://celoscan.io/address/0xFa51eFDc0910CCdA91732e6806912Fa12e2FD475">0xFa51eFDc0910CCdA91732e6806912Fa12e2FD475</a><br><br>(production G$) <a href="https://celoscan.io/address/0x62b8b11039fcfe5ab0c56e502b1c372a3d2a9c7a?a=0xe738edd568147d3fc4583894ff0ad19d2ced11f8&#x26;utm_source=chatgpt.com"><code>0x62B8B11039fcfE5AB0C56E502b1C372A3D2a9C7A</code></a></p> |
| `CFAv1Forwarder` universal address               | `0xcfA132E353cB4E398080B9700609bb008eceB125` ([docs.superfluid.finance](https://docs.superfluid.finance/docs/technical-reference/CFAv1Forwarder))                                                                                                                                                                                                                                                                                                 |

***

### Project Setup

```bash
npm i ethers wagmi viem
```

```ts
// lib/superfluid.ts
import { BrowserProvider } from 'ethers';

export const provider = new BrowserProvider(window.ethereum);
export const forwarderAddr = '0xcfA132E353cB4E398080B9700609bb008eceB125';
export const gDollar     = '0x62B8B11039fcfE5AB0C56E502b1C372A3D2a9C7A';

// paste the CFAv1Forwarder ABI snippet from the tech-ref page ↓
import { CFAv1ForwarderAbi } from './CFAv1ForwarderAbi';

export const forwarder = new ethers.Contract(
  forwarderAddr,
  CFAv1ForwarderAbi,
  provider.getSigner()
);
```

*The full ABI is on the technical-reference page and includes helpers like `getBufferAmountByFlowrate`.* ([docs.superfluid.finance](https://docs.superfluid.finance/docs/technical-reference/CFAv1Forwarder))

***

### Creating a Flow (React / wagmi example)

```tsx
import { useState } from 'react';
import { useAccount } from 'wagmi';
import { forwarder, gDollar } from './lib/superfluid';

// helper – convert “tokens per month” → int96 wad/sec
const perMonthToRate = (pm: string) =>
  BigInt(pm) * 10n ** 18n / 2592000n; // 30 × 24 × 60 × 60

export default function CreateFlow() {
  const { address } = useAccount();
  const [receiver, setReceiver] = useState('');
  const [perMonth, setPerMonth] = useState('10');

  async function start() {
    const tx = await forwarder.createFlow(
      gDollar,
      address!,        // sender (caller)
      receiver,
      perMonthToRate(perMonth), // int96 flowRate
      '0x'             // userData
    );
    await tx.wait();
  }

  return (
    <>
      <input value={receiver} onChange={e=>setReceiver(e.target.value)} />
      <button onClick={start}>
        Stream {perMonth} G$/mo
      </button>
    </>
  );
}
```

The same pattern works for **`updateFlow`** and **`deleteFlow`**; just swap the method. ([docs.superfluid.finance](https://docs.superfluid.finance/docs/sdk/money-streaming/create-update-delete-flow))

***

### Reading Live Data

```ts
// How fast am I sending right now?
const { flowrate } = await forwarder.getFlowInfo(
  gDollar,
  sender,
  receiver
);

// How big a safety buffer does Superfluid require for 10 G$/mo?
const buffer = await forwarder.getBufferAmountByFlowrate(
  gDollar,
  perMonthToRate('10')
);
```

These helper views are defined in the same contract. ([docs.superfluid.finance](https://docs.superfluid.finance/docs/technical-reference/CFAv1Forwarder))\
For historical analytics use the **Superfluid Subgraph** or Explorer. ([docs.superfluid.finance](https://docs.superfluid.finance/docs/sdk/money-streaming/subgraph))

***

### Registering Your dApp as a Super-App (optional)

If your contract should *react* to incoming/outgoing streams (e.g. auto-staking or NFT minting), you want your dApp to be registered as Super-App.

{% hint style="warning" %}
For instructions please follow: <https://docs.superfluid.org/docs/protocol/advanced-topics/super-apps/register>\
\
The Celo network requires a 'deployer' to be whitelisted before it can be registered. [Please reach out to us to help you get whitelisted.](https://t.me/gooddollarbounties/1)
{% endhint %}

***

### 6 Next Steps & Gotchas

<table><thead><tr><th width="217">Topic</th><th width="532.39990234375">What to watch for</th></tr></thead><tbody><tr><td><strong>GDAv1Forwarder</strong></td><td>Needed for pool-style “one-to-many” distributions; interface is analogous to CFA but targets pools. (<a href="https://docs.superfluid.finance/docs/technical-reference/GDAv1Forwarder">docs.superfluid.finance</a>)</td></tr><tr><td><strong>Flow-rate math</strong></td><td><code>rate = amountPerMonth × 1e18 / 2 592 000</code>. Keep <code>int96</code> limits (~10^27 total). (<a href="https://docs.superfluid.finance/docs/sdk/money-streaming/create-update-delete-flow">docs.superfluid.finance</a>)</td></tr><tr><td><strong>Buffer deposits</strong></td><td>Use <code>getBufferAmountByFlowrate</code> before creating a stream to make sure the sender holds ≥ buffer + first few minutes. (<a href="https://docs.superfluid.finance/docs/technical-reference/CFAv1Forwarder">docs.superfluid.finance</a>)</td></tr><tr><td><strong>Protocol fees</strong></td><td>G$ applies its <code>_processFees</code> on each streamed “drip”; receiver gets <code>flowRate – feeRate</code>.</td></tr><tr><td><strong>Network support</strong></td><td>Streaming live only on Celo today; G$ on Fuse &#x26; ETH can still use one-off transfers.</td></tr><tr><td><strong>Testing</strong></td><td>Use GoodDollar’s dev contract <code>0xFa51eFDc0910CCdA91732e6806912Fa12e2FD475</code>. You can claim some free dev G$'s by creating a dev wallet here: <a href="https://goodwallet.dev/">https://goodwallet.dev</a></td></tr></tbody></table>

***

### Reference Links

1. **Create/Update/Delete Flows guide** (Superfluid SDK) ([docs.superfluid.finance](https://docs.superfluid.finance/docs/sdk/money-streaming/create-update-delete-flow))
2. **CFAv1Forwarder technical reference** ([docs.superfluid.finance](https://docs.superfluid.finance/docs/technical-reference/CFAv1Forwarder))
3. **GDAv1Forwarder reference** (for next steps) ([docs.superfluid.finance](https://docs.superfluid.finance/docs/technical-reference/GDAv1Forwarder?utm_source=chatgpt.com))
4. **SuperTokenV1Library** (Solidity helper) ([docs.superfluid.finance](https://docs.superfluid.finance/docs/technical-reference/SuperTokenV1Library))
5. **Super-Apps concepts** page ([docs.superfluid.finance](https://docs.superfluid.finance/docs/concepts/advanced-topics/super-apps))
6. **Host & Super-App architecture** ([docs.superfluid.finance](https://docs.superfluid.finance/docs/protocol/advanced-topics/super-apps/register))
7. **App-Registry wiki / registerApp** ([GitHub](https://github.com/superfluid-org/protocol-monorepo/wiki/About-App-Registry))
8. **Agreement Forwarders overview** ([GitHub](https://github.com/superfluid-org/protocol-monorepo/wiki/About-Agreement-Forwarders))
9. **G$ token contract on CeloScan** ([Celo Chain Blockchain Explorer](https://celoscan.io/address/0x62b8b11039fcfe5ab0c56e502b1c372a3d2a9c7a?a=0xe738edd568147d3fc4583894ff0ad19d2ced11f8))

***


---

# 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.gooddollar.org/for-developers/developer-guides/use-gusd-streaming.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.