GIWA React Native SDK
GIWA Chain을 위한 React Native SDK입니다. Expo와 React Native CLI 프로젝트 모두에서 사용 가능합니다.
주요 기능
✅ 현재 사용 가능
| 기능 | Hook | 설명 |
|---|---|---|
| 지갑 관리 | useGiwaWallet | 지갑 생성, 복구, 가져오기, 내보내기 |
| 잔액 조회 | useBalance | ETH 및 토큰 잔액 조회 |
| 트랜잭션 | useTransaction | ETH 전송 |
| 토큰 관리 | useTokens | ERC-20 토큰 전송 및 조회 |
| Flashblocks | useFlashblocks | ~200ms 빠른 사전확인 |
| Dojang (EAS) | useDojang | 온체인 증명 서비스 |
| Faucet | useFaucet | 테스트넷 ETH 수령 |
| 네트워크 정보 | useNetworkInfo | 네트워크 상태 및 기능 가용성 |
| 생체 인증 | useBiometricAuth | Face ID / Touch ID / 지문 인식 |
| 보안 저장소 | - | iOS Keychain / Android Keystore |
🚧 준비중 (컨트랙트 배포 대기)
이 기능들은 SDK에 완전히 구현되어 있지만, GIWA 팀의 스마트 컨트랙트 배포가 필요합니다.
| 기능 | Hook | 상태 | 공식 문서 |
|---|---|---|---|
| L1 브릿지 | useBridge | L1 브릿지 컨트랙트 미배포 | GIWA 문서 |
| GIWA ID | useGiwaId | ENS 컨트랙트 미배포 | GIWA 문서 |
브릿지 대안
브릿지 기능이 필요하시면 Superbridge를 이용하실 수 있습니다.
네트워크 정보
| 네트워크 | Chain ID | RPC URL | 상태 |
|---|---|---|---|
| Testnet | 91342 | https://sepolia-rpc.giwa.io/ | ✅ 사용 가능 |
| Mainnet | - | - | 🚧 개발중 |
메인넷 개발중
메인넷은 현재 개발 중입니다. 개발 및 테스트에는 테스트넷을 사용해 주세요.
빠른 시작
# Expo
npx expo install giwa-react-native-wallet expo-secure-store expo-local-authentication react-native-get-random-values
# React Native CLI
npm install giwa-react-native-wallet react-native-keychain react-native-get-random-values
cd ios && pod install
import { GiwaProvider, useGiwaWallet } from "giwa-react-native-wallet";
export default function App() {
return (
<GiwaProvider network="testnet">
<WalletScreen />
</GiwaProvider>
);
}
function WalletScreen() {
const { wallet, createWallet } = useGiwaWallet();
return wallet ? (
<Text>Address: {wallet.address}</Text>
) : (
<Button title="Create Wallet" onPress={createWallet} />
);
}
요구 사항
- React >= 19.0.0
- React Native >= 0.77.0
- Expo SDK >= 53 (Expo 프로젝트)
- expo-secure-store >= 15.0.0 (Expo)
- expo-local-authentication >= 14.0.0 (Expo, 생체 인증용)
- react-native-keychain >= 9.2.0 (React Native CLI)
- react-native-get-random-values >= 1.11.0
GIWA 공식 리소스
| 리소스 | URL |
|---|---|
| GIWA 문서 | docs.giwa.io |
| 샘플 앱 (GitHub) | giwa-react-native-samples |
| Bridge (Superbridge) | superbridge.app |
| Faucet | faucet.giwa.io |
| Block Explorer | sepolia-explorer.giwa.io |