@dj-test/payment-sdk 1.0.0

package/README.md

@@ -0,0 +1,325 @@
+# Payment SDK
+
+wagmi 기반의 결제 SDK로, 두 가지 결제 방식을 지원합니다.
+
+## 주요 기능
+
+### 1. Pay with Wallet (지갑 연결 결제)
+- ✅ 지갑 설치 여부 자동 감지
+- ✅ 다양한 지갑 지원 (MetaMask, WalletConnect, Coinbase Wallet)
+- ✅ 지갑 선택 UI 제공
+- ✅ 실시간 트랜잭션 확인
+- ✅ 네트워크 자동 전환
+- ✅ 송금 주소, 금액, 코인 설정
+
+### 2. Pay with Address (주소 결제)
+- ✅ QR 코드 생성
+- ✅ 주소 복사 기능
+- ✅ 만료 시간 표시
+- ✅ 결제 안내문
+
+## Installation
+
+```bash
+pnpm add payment-sdk wagmi viem @tanstack/react-query
+```
+
+## Quick Start
+
+### 1. Wrap your app with Providers
+
+```tsx
+import { PaymentProvider, WalletProvider } from 'payment-sdk';
+
+function App() {
+  return (
+    <WalletProvider>
+      <PaymentProvider
+        apiKey="your-api-key"
+        environment="production"
+        baseUrl={process.env.NEXT_PUBLIC_API_URL}
+        redirectUrl="https://yoursite.com/payment/success"
+        webhookUrl="https://yoursite.com/api/webhook/payment"
+      >
+        <YourApp />
+      </PaymentProvider>
+    </WalletProvider>
+  );
+}
+```
+
+### 2. Pay with Wallet
+
+```tsx
+import { PayWithWallet } from 'payment-sdk';
+
+function CheckoutPage() {
+  return (
+    <PayWithWallet
+      toAddress="0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb"
+      amount="100"
+      coinId="USDC"
+      chainId={11155111} // Sepolia testnet
+      onSuccess={(txHash) => console.log('Success:', txHash)}
+      onError={(error) => console.error('Error:', error)}
+    />
+  );
+}
+```
+
+### 3. Pay with Address
+
+```tsx
+import { PayWithAddress } from 'payment-sdk';
+
+function PaymentPage() {
+  return (
+    <PayWithAddress
+      walletAddress="0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb"
+      amount="100"
+      coinId="USDC"
+      chainId={11155111}
+      publicOrderId="order-uuid"
+      expiresAt="2025-01-04T15:30:00"
+    />
+  );
+}
+```
+
+### 4. Use Wallet Hook (Legacy - EVM Only)
+
+```tsx
+import { useWallet } from 'payment-sdk';
+
+function WalletComponent() {
+  const {
+    wallet,
+    isConnected,
+    connect,
+    disconnect,
+    connectors,
+    sendPayment,
+  } = useWallet();
+
+  return (
+    <div>
+      {!isConnected ? (
+        <button onClick={() => connect('injected')}>
+          Connect Wallet
+        </button>
+      ) : (
+        <>
+          <p>Connected: {wallet?.address}</p>
+          <button onClick={disconnect}>Disconnect</button>
+        </>
+      )}
+    </div>
+  );
+}
+```
+
+### 5. Use Wallet Adapter Hook (Multi-chain Support)
+
+```tsx
+import { useWalletAdapter, WalletTypes } from 'payment-sdk';
+
+function MultiChainWallet() {
+  const {
+    wallet,
+    isConnected,
+    connect,
+    disconnect,
+    chainType,
+    balance,
+    sendPayment,
+  } = useWalletAdapter();
+
+  const connectEvm = () => {
+    connect(WalletTypes.EVM, 'injected'); // MetaMask
+  };
+
+  const connectTron = () => {
+    connect(WalletTypes.TRON, 'tronlink'); // TronLink
+  };
+
+  return (
+    <div>
+      {!isConnected ? (
+        <>
+          <button onClick={connectEvm}>Connect MetaMask</button>
+          <button onClick={connectTron}>Connect TronLink</button>
+        </>
+      ) : (
+        <>
+          <p>Chain: {chainType}</p>
+          <p>Address: {wallet?.address}</p>
+          <p>Balance: {balance?.formatted} {balance?.symbol}</p>
+          <button onClick={disconnect}>Disconnect</button>
+        </>
+      )}
+    </div>
+  );
+}
+```
+
+### 6. Tron Payment Example
+
+```tsx
+import { PayWithWallet } from 'payment-sdk';
+
+function TronPayment() {
+  return (
+    <PayWithWallet
+      toAddress="TXYZoPEU" // Tron address (starts with T)
+      amount="100"
+      coinId="USDT"
+      chainId="mainnet" // Tron mainnet
+      onSuccess={(txHash) => console.log('Tron TX:', txHash)}
+      onError={(error) => console.error('Error:', error)}
+    />
+  );
+}
+```
+
+### 7. Auto-detect Chain by Address
+
+```tsx
+import { useWalletAdapter } from 'payment-sdk';
+
+function AutoDetectPayment({ depositAddress }: { depositAddress: string }) {
+  // Automatically selects EVM or Tron adapter based on address format
+  // 0x... -> EVM adapter
+  // T... -> Tron adapter
+  const adapter = useWalletAdapter({ depositAddress });
+
+  return (
+    <div>
+      <p>Detected Chain: {adapter.chainType}</p>
+      <button onClick={() => adapter.connect(adapter.adapterType!, 'injected')}>
+        Connect Wallet
+      </button>
+    </div>
+  );
+}
+```
+
+## Supported Networks
+
+### EVM Chains
+- Ethereum Mainnet (1)
+- Sepolia Testnet (11155111)
+- Polygon Mainnet (137)
+- Polygon Amoy Testnet (80002)
+- Base Mainnet (8453)
+- Base Sepolia (84532)
+
+### Tron Networks
+- Tron Mainnet (`mainnet`)
+- Tron Shasta Testnet (`shasta`)
+- Tron Nile Testnet (`nile`)
+
+## Supported Wallets
+
+### EVM Wallets
+- **Injected Wallets**: MetaMask, Trust Wallet, Brave Wallet
+- **WalletConnect**: 200+ 모바일 지갑
+- **Coinbase Wallet**: Coinbase 공식 지갑
+
+### Tron Wallets
+- **TronLink**: Official Tron wallet extension
+- **TronLink Pro**: Mobile wallet with WalletConnect support
+
+## API Reference
+
+### PaymentProvider Props
+
+| Prop | Type | Required | Description |
+|------|------|----------|-------------|
+| apiKey | string | Yes | Your API key |
+| environment | 'production' \| 'sandbox' | Yes | Environment |
+| baseUrl | string | No | Custom API URL |
+| redirectUrl | string | Yes | Success redirect URL |
+| webhookUrl | string | Yes | Webhook endpoint URL |
+| timeout | number | No | Request timeout (default: 30000ms) |
+
+### usePayment Hook
+
+Returns:
+- `createOrder(params)` - Create a new payment order
+- `isLoading` - Loading state
+- `error` - Error object
+- `order` - Created order object
+- `errorMessage` - User-friendly error message
+
+### useOrder Hook
+
+```tsx
+const { order, isLoading, error, refetch } = useOrder(publicOrderId);
+```
+
+Returns order details and allows manual refresh.
+
+### Validation Utils
+
+```tsx
+import { validation } from '@your-company/payment-sdk';
+
+// Validate withdrawal address
+const result = validation.validateWithdrawalAddress(fromAddress, toAddress);
+if (!result.valid) {
+  console.error(result.error);
+}
+
+// Validate Ethereum address format
+const isValid = validation.isValidEthereumAddress(address);
+```
+
+## Security Features
+
+### 1. Order ID Security
+- Uses UUID for public order IDs (unpredictable)
+- Internal database IDs remain hidden
+
+### 2. Withdrawal Validation
+- Prevents sending to your own wallet address
+- Validates address format
+- Validates amount
+
+### 3. API Security
+- HTTPS required for production
+- API key authentication
+- Webhook signature verification
+
+## Payment Flow
+
+1. **Create Order**: Merchant calls `createOrder()`
+2. **Redirect**: User redirected to payment page
+3. **Payment**: User sends crypto to wallet address
+4. **Monitor**: System monitors blockchain for deposit
+5. **Complete**: Webhook sent to merchant, user redirected to success page
+
+## Environment Variables
+
+```env
+NEXT_PUBLIC_API_URL=https://api.yourpayment.com
+NEXT_PUBLIC_API_KEY=your-api-key-here
+NEXT_PUBLIC_REDIRECT_URL=https://yoursite.com/payment/success
+NEXT_PUBLIC_WEBHOOK_URL=https://yoursite.com/api/webhook/payment
+NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID=your-walletconnect-project-id
+```
+
+Get WalletConnect Project ID at [WalletConnect Cloud](https://cloud.walletconnect.com/)
+
+## Examples
+
+See the [examples](./examples) directory for complete integration examples.
+
+## Support
+
+- Documentation: https://docs.yourpayment.com
+- Email: support@yourcompany.com
+- GitHub: https://github.com/yourcompany/payment-sdk
+
+## License
+
+MIT

package/dist/chunk-3AOMSDLI.mjs

@@ -0,0 +1,223 @@
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+
+// src/api/orders.ts
+var orders_exports = {};
+__export(orders_exports, {
+  createOrder: () => createOrder,
+  getOrder: () => getOrder,
+  getOrders: () => getOrders,
+  notifyTransaction: () => notifyTransaction
+});
+
+// src/api/client.ts
+import axios from "axios";
+
+// src/core/constants.ts
+var SDK_VERSION = "1.0.0";
+var API_ENDPOINTS = {
+  ORDERS: "/payments",
+  PRODUCTS: "/products"
+};
+var ENVIRONMENT_URLS = {
+  production: "https://pay.com",
+  sandbox: "http://localhost:8080"
+};
+var PAYMENT_DOMAINS = {
+  production: "https://pay-home.com",
+  sandbox: "http://localhost:3000"
+};
+var DEFAULT_TIMEOUT = 3e4;
+var ORDER_EXPIRY_MINUTES = 30;
+var MIN_WITHDRAWAL_AMOUNT = 0.01;
+var SUPPORTED_CHAINS = {
+  ETHEREUM: "1",
+  SEPOLIA: "11155111",
+  POLYGON: "137"
+};
+var ERROR_CODES = {
+  INVALID_API_KEY: "INVALID_API_KEY",
+  INVALID_PRODUCT: "INVALID_PRODUCT",
+  ORDER_NOT_FOUND: "ORDER_NOT_FOUND",
+  ORDER_EXPIRED: "ORDER_EXPIRED",
+  INSUFFICIENT_BALANCE: "INSUFFICIENT_BALANCE",
+  SELF_TRANSFER: "SELF_TRANSFER",
+  INVALID_ADDRESS: "INVALID_ADDRESS",
+  NETWORK_ERROR: "NETWORK_ERROR"
+};
+
+// src/core/config.ts
+var Config = class _Config {
+  constructor() {
+    this.config = null;
+  }
+  static getInstance() {
+    if (!_Config.instance) {
+      _Config.instance = new _Config();
+    }
+    return _Config.instance;
+  }
+  initialize(config2) {
+    if (!config2.baseUrl && config2.environment) {
+      config2.baseUrl = ENVIRONMENT_URLS[config2.environment];
+    }
+    if (!config2.timeout) {
+      config2.timeout = DEFAULT_TIMEOUT;
+    }
+    this.config = config2;
+  }
+  getConfig() {
+    if (!this.config) {
+      return {
+        environment: "sandbox",
+        baseUrl: ENVIRONMENT_URLS.sandbox,
+        timeout: DEFAULT_TIMEOUT
+      };
+    }
+    return this.config;
+  }
+  isInitialized() {
+    return this.config !== null;
+  }
+  reset() {
+    this.config = null;
+  }
+};
+var config = Config.getInstance();
+
+// src/types/sdk.ts
+var SDKError = class extends Error {
+  constructor(message, code, details) {
+    super(message);
+    this.code = code;
+    this.details = details;
+    this.name = "SDKError";
+  }
+};
+var APIError = class extends SDKError {
+  constructor(message, statusCode, details) {
+    super(message, "API_ERROR", details);
+    this.statusCode = statusCode;
+    this.name = "APIError";
+  }
+};
+
+// src/api/client.ts
+var APIClient = class {
+  constructor() {
+    this.instance = null;
+  }
+  getClient() {
+    if (!this.instance) {
+      const sdkConfig = config.getConfig();
+      this.instance = axios.create({
+        baseURL: sdkConfig.baseUrl,
+        timeout: sdkConfig.timeout,
+        headers: {
+          "Content-Type": "application/json"
+        },
+        withCredentials: true
+        // 기존 프로젝트 패턴과 일치
+      });
+      this.instance.interceptors.request.use(
+        (requestConfig) => {
+          return requestConfig;
+        },
+        (error) => Promise.reject(error)
+      );
+      this.instance.interceptors.response.use(
+        (response) => response,
+        (error) => {
+          const status = error.response?.status;
+          const data = error.response?.data;
+          const message = data?.message || error.message;
+          const details = error.response?.data;
+          throw new APIError(message, status, details);
+        }
+      );
+    }
+    return this.instance;
+  }
+  reset() {
+    this.instance = null;
+  }
+};
+var apiClient = new APIClient();
+
+// src/api/orders.ts
+var createOrder = async (productId, redirectUrl, webhookUrl) => {
+  const request = {
+    productId,
+    redirectUrl,
+    webhookUrl
+  };
+  const response = await apiClient.getClient().post(
+    API_ENDPOINTS.ORDERS,
+    request
+  );
+  const order = response.data.output;
+  return {
+    orderId: order.uuid,
+    publicOrderId: order.uuid,
+    paymentUrl: "",
+    // 사용 안 함
+    amount: 0,
+    // 주문 생성 시점에는 없음
+    coinId: "",
+    // 주문 생성 시점에는 없음
+    chainId: "",
+    // 주문 생성 시점에는 없음
+    status: order.status,
+    expiresAt: "",
+    // 주문 생성 시점에는 없음
+    redirectUrl: order.redirectUrl || null
+    // 서버 응답의 redirectUrl
+  };
+};
+var getOrder = async (publicOrderId) => {
+  const response = await apiClient.getClient().get(
+    `${API_ENDPOINTS.ORDERS}/${publicOrderId}`
+  );
+  const orderData = response.data.output;
+  if (!orderData || typeof orderData !== "object") {
+    throw new Error("Order data is null or invalid");
+  }
+  if (!orderData.orderId || orderData.orderStat === void 0 || orderData.orderStat === null) {
+    throw new Error("Order data is incomplete - missing required fields");
+  }
+  return orderData;
+};
+var getOrders = async () => {
+  const response = await apiClient.getClient().get(API_ENDPOINTS.ORDERS);
+  return response.data.output;
+};
+var notifyTransaction = async (publicOrderId, txHash) => {
+  await apiClient.getClient().post(
+    `${API_ENDPOINTS.ORDERS}/${publicOrderId}/transaction`,
+    { txHash }
+  );
+};
+
+export {
+  __export,
+  SDK_VERSION,
+  API_ENDPOINTS,
+  ENVIRONMENT_URLS,
+  PAYMENT_DOMAINS,
+  DEFAULT_TIMEOUT,
+  ORDER_EXPIRY_MINUTES,
+  MIN_WITHDRAWAL_AMOUNT,
+  SUPPORTED_CHAINS,
+  ERROR_CODES,
+  config,
+  SDKError,
+  APIError,
+  createOrder,
+  getOrder,
+  getOrders,
+  notifyTransaction,
+  orders_exports
+};