add send_usd example

Author: cctdaniel

.env.sample

@@ -0,0 +1,5 @@
+WALLET_VERSION="v4"
+WALLET_MNEMONIC=""
+TONCENTER_API_KEY="" # Get from https://toncenter.com/
+PYTH_CONTRACT_ADDRESS="EQB4ZnrI5qsP_IUJgVJNwEGKLzZWsQOFhiaqDbD7pTt_f9oU" 
+SEND_USD_CONTRACT_ADDRESS=""

.gitignore

@@ -1,58 +1,18 @@
-# Logs
-logs
-*.log
-npm-debug.log*
-yarn-debug.log*
-yarn-error.log*
-.idea
+node_modules
+temp
 build
+dist
+.DS_Store
 
-# node-waf configuration
-.lock-wscript
-
-# Compiled binary addons (https://nodejs.org/api/addons.html)
-build/Release
-
-# Dependency directories
-node_modules/
-**/node_modules/
-jspm_packages/
-
-# TypeScript v1 declaration files
-typings/
-
-# Optional npm cache directory
-.npm
-
-# Optional eslint cache
-.eslintcache
-
-# Optional REPL history
-.node_repl_history
+# VS Code
+.vscode/*
+.history/
+*.vsix
 
-# Output of 'npm pack'
-*.tgz
+# IDEA files
+.idea
 
-# Yarn Integrity file
-.yarn-integrity
+# VIM
+Session.vim
 
-# dotenv environment variables file
 .env
-
-# parcel-bundler cache (https://parceljs.org/)
-.cache
-
-# next.js build output
-.next
-
-# nuxt.js build output
-.nuxt
-
-# vuepress build output
-.vuepress/dist
-
-# MacOS specific
-.DS_Store
-
-# Cargo build output
-target/

.prettierignore

@@ -0,0 +1 @@
+build

.prettierrc

@@ -0,0 +1,7 @@
+{
+    "printWidth": 120,
+    "tabWidth": 4,
+    "singleQuote": true,
+    "bracketSpacing": true,
+    "semi": true
+}

README.md

@@ -1,3 +1,83 @@
-#  Pyth Examples
+# 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` - Smart contract source code and dependencies
+-   `wrappers` - Contract wrapper classes implementing serialization and compilation
+-   `tests` - Contract test suite
+-   `scripts` - Deployment and interaction scripts
+
+## Development
+
+### Build
+
+`npx blueprint build` or `yarn blueprint build`
+
+### Test
+
+`npx blueprint test` or `yarn blueprint test`
+
+### Deploy or run scripts
+
+`npx blueprint run` or `yarn blueprint run`
+
+### Create new contract
+
+`npx blueprint create ContractName` or `yarn blueprint create ContractName`