update readme

Author: cctdaniel

price_feeds/ton/send_usd/README.md

@@ -1,13 +1,70 @@
 # send_usd
 
+This repository contains examples of applications integrating Pyth products and services.	Sample contract demonstrating Pyth price feed integration on TON.
+
+## Overview
+
+This contract enables USD-denominated payments on TON by integrating with Pyth price oracles. It supports two operations:
+
+1. `send_usd` - Send a USD-denominated payment that gets converted to TON at current price
+
+Message format:
+
+```typescript
+{
+    queryId: number,     // 64-bit unique identifier for the request
+    recipient: Address,  // TON address of payment recipient
+    usdAmount: number,  // Amount in USD dollars
+    updateData: Buffer, // Pyth price update data (converted to cell chain)
+    value: bigint      // Amount of TON to attach to message
+}
+```
+
+The `updateData` field contains Pyth price feed data and must be obtained from [Hermes](https://hermes.pyth.network/docs/). This data is converted to a TON cell chain format using the `createCellChain()` helper from the [pyth-ton-js](https://www.npmjs.com/package/@pythnetwork/pyth-ton-js) library. The Pyth contract can be found [here](https://github.com/pyth-network/pyth-crosschain/tree/main/target_chains/ton/contracts).
+
+2. Pyth price update callback
+
+-   Receives price updates from Pyth oracle contract
+-   Automatically processes pending USD payments using latest price
+
+## Setup
+
+1.  Copy environment config:
+
+```bash
+cp .env.example .env
+```
+
+2.  Configure `.env`:
+
+```
+WALLET_MNEMONIC="your mnemonic here"
+```
+
+## Usage
+
+1.  Deploy contract:
+
+```bash
+npx blueprint run deploySendUsd --custom https://testnet.toncenter.com/api/v2/jsonRPC --custom-version v2 --custom-type testnet --custom-key <YOUR-API-KEY> --mnemonic
+```
+
+This will deploy the contract and update `.env` with the deployed address.
+
+2. Send USD payment:
+
+```bash
+npx blueprint run sendUsdPayment <YOUR-TON-WALLET-ADDRESS> 1 --custom https://testnet.toncenter.com/api/v2/jsonRPC --custom-version v2 --custom-type testnet --custom-key <YOUR-API-KEY> --mnemonic
+```
+
 ## Project structure
 
--   `contracts` - source code of all the smart contracts of the project and their dependencies.
--   `wrappers` - wrapper classes (implementing `Contract` from ton-core) for the contracts, including any [de]serialization primitives and compilation functions.
--   `tests` - tests for the contracts.
--   `scripts` - scripts used by the project, mainly the deployment scripts.
+-   `contracts` - Smart contract source code and dependencies
+-   `wrappers` - Contract wrapper classes implementing serialization and compilation
+-   `tests` - Contract test suite
+-   `scripts` - Deployment and interaction scripts
 
-## How to use
+## Development
 
 ### Build
 
@@ -17,10 +74,10 @@
 
 `npx blueprint test` or `yarn blueprint test`
 
-### Deploy or run another script
+### Deploy or run scripts
 
 `npx blueprint run` or `yarn blueprint run`
 
-### Add a new contract
+### Create new contract
 
 `npx blueprint create ContractName` or `yarn blueprint create ContractName`