@easysui/sdk 0.0.1

package/README.md

@@ -0,0 +1,108 @@
+# EasySui SDK
+
+Easy-to-use TypeScript SDK for Sui blockchain development.
+
+## Installation
+
+```bash
+npm install @easysui/sdk
+# or
+pnpm add @easysui/sdk
+# or
+yarn add @easysui/sdk
+```
+
+## Usage
+
+```typescript
+import { Config, getKeypair, deploySuiPackage } from '@easysui/sdk'
+
+// Get configuration
+const config = Config.vars
+
+// Create keypair from private key
+const keypair = getKeypair('your-private-key')
+
+// Deploy a package
+const result = await deploySuiPackage(config.PACKAGE_PATH)
+```
+
+## Features
+
+- **Configuration Management**: Easy configuration with environment-specific settings
+- **Token Utilities**: Helpers for working with Sui tokens and USDC
+- **Deployment Tools**: Simplified package deployment and upgrades
+- **Cost Analysis**: Gas cost estimation and analysis
+- **Test Utilities**: Testing helpers for Sui development
+
+## API Reference
+
+### Config
+
+```typescript
+import { Config } from '@easysui/sdk'
+
+// Access configuration variables
+const vars = Config.vars
+
+// Write configuration to .env file
+Config.write(configVars)
+```
+
+### Keypair Management
+
+```typescript
+import { getKeypair } from '@easysui/sdk'
+
+const keypair = getKeypair(privateKey)
+```
+
+### Package Deployment
+
+```typescript
+import { deploySuiPackage, upgradeSuiPackage } from '@easysui/sdk'
+
+// Deploy new package
+const deployResult = await deploySuiPackage(packagePath)
+
+// Upgrade existing package
+const upgradeResult = await upgradeSuiPackage(packagePath, upgradeCapId)
+```
+
+## Development
+
+```bash
+# Install dependencies
+pnpm install
+
+# Build the package
+pnpm build
+
+# Run tests
+pnpm test
+
+# Lint code
+pnpm lint
+
+# Format code
+pnpm fix
+```
+
+## Publishing
+
+This package uses [Changesets](https://github.com/changesets/changesets) for version management and publishing.
+
+```bash
+# Add a changeset
+pnpm changeset
+
+# Version packages
+pnpm version
+
+# Build and publish to npm
+pnpm release
+```
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -0,0 +1,118 @@
+import { Keypair } from '@mysten/sui/cryptography';
+import { Transaction } from '@mysten/sui/transactions';
+import * as _mysten_sui_client from '@mysten/sui/client';
+import { SuiTransactionBlockResponse, SuiObjectChangePublished, SuiObjectChangeCreated, SuiClient as SuiClient$1 } from '@mysten/sui/client';
+import { Ed25519Keypair } from '@mysten/sui/keypairs/ed25519';
+
+declare const DENY_LIST_ID = "0x403";
+declare const CLOCK_ID = "0x6";
+type Network = 'mainnet' | 'testnet' | 'devnet' | 'localnet';
+interface ConfigVars {
+    NETWORK: Network;
+    RPC: string;
+    PACKAGE_PATH: string;
+    PACKAGE_ID: string;
+    UPGRADE_CAP_ID: string;
+    USDC_PACKAGE_ID?: string;
+    USDC_TREASURY_CAP?: string;
+}
+declare const ADMIN_KEYPAIR: Keypair;
+declare class Config {
+    private static instance;
+    private static getInstance;
+    get env(): Network;
+    static get vars(): ConfigVars;
+    static write(config: ConfigVars): string;
+}
+
+declare const STATIC_CONFIGS: any;
+
+declare class Coin {
+    static get coinType(): string;
+    static getBalance(owner: string): Promise<bigint>;
+    static getCoin(owner: Keypair, amount?: bigint): Promise<string>;
+    static _mint(treasuryId: string, amount: bigint, minter: Keypair): Promise<void>;
+    static send(amount: bigint, from: Keypair, to: string): Promise<void>;
+    static assertBalance(wallet: Keypair, amount: bigint | BigInt): Promise<void>;
+}
+
+declare class USDC extends Coin {
+    static get coinType(): string;
+    private static getMintCapId;
+    static faucet(amount: bigint, receiver: string, admin: Keypair): Promise<void>;
+}
+
+declare function analyze_cost(ptb: Transaction, resp: SuiTransactionBlockResponse): void;
+
+declare function deploy(vars?: ConfigVars): Promise<string>;
+declare function getDeployBytes(): Promise<string>;
+
+declare function getKeypair(privkey: string): Keypair;
+
+declare class PublishSingleton {
+    private readonly publishResp;
+    private static instance;
+    private constructor();
+    private static getDeployVars;
+    static publish(signer?: Keypair, packagePath?: string): Promise<void>;
+    private static getInstance;
+    static publishResponse(): SuiTransactionBlockResponse;
+    static get packageId(): string;
+    private static findObjectIdByType;
+    static get upgradeCapId(): string;
+    static get usdcTreasuryCap(): string;
+    static getPublishTx(packagePath: string, signer: Keypair): Transaction;
+    static getPublishBytes(signer?: Keypair, packagePath?: string): Promise<string>;
+    static publishPackage(signer: Keypair, packagePath: string): Promise<SuiTransactionBlockResponse>;
+    static findPublishedPackage(resp: SuiTransactionBlockResponse): SuiObjectChangePublished | undefined;
+    static findObjectChangeCreatedByType(resp: SuiTransactionBlockResponse, type: string): SuiObjectChangeCreated | undefined;
+}
+
+declare enum MoveType {
+    u8 = 0,
+    u16 = 1,
+    u32 = 2,
+    u64 = 3,
+    u128 = 4,
+    u256 = 5,
+    bool = 6,
+    string = 7,
+    object = 8,
+    address = 9,
+    address_opt = 10,
+    vec_address = 11
+}
+declare class SuiClient {
+    private static instance;
+    private client;
+    private constructor();
+    private static getInstance;
+    static get client(): SuiClient$1;
+    static signAndExecute(ptb: Transaction, signer: Keypair, errorHandler?: (e: any) => string): Promise<_mysten_sui_client.SuiTransactionBlockResponse>;
+    static toMoveArg(ptb: Transaction, value: any, type?: MoveType): any;
+    static moveCall({ signer, target, typeArgs, args, argTypes, errorHandler, ptb, withTransfer, }: {
+        signer: Keypair;
+        target: string;
+        typeArgs?: string[];
+        args?: any[];
+        argTypes?: MoveType[];
+        errorHandler?: (e: any) => string;
+        ptb?: Transaction;
+        withTransfer?: boolean;
+    }): Promise<_mysten_sui_client.SuiTransactionBlockResponse>;
+    static public_transfer(objects: string[], from: Keypair, to: string): Promise<_mysten_sui_client.SuiTransactionBlockResponse>;
+    static devInspect(ptb: Transaction, sender: string): Promise<_mysten_sui_client.DevInspectResults>;
+    static devInspectRaw(ptb: Transaction, sender: string): Promise<number[] | undefined>;
+    static devInspectBool(ptb: Transaction, sender: string): Promise<boolean | undefined>;
+    static devInspectU64(ptb: Transaction, sender: string): Promise<bigint>;
+    static devInspectAddress(ptb: Transaction, sender: string): Promise<string | undefined>;
+    static getObject(id: string): Promise<_mysten_sui_client.SuiObjectResponse>;
+    static getObjectsByType(owner: string, type: string): Promise<(string | undefined)[]>;
+}
+
+declare function createWallet(): Ed25519Keypair;
+declare function createFundedWallet(usdcAmount?: bigint): Promise<Ed25519Keypair>;
+declare function sleep(ms: number): Promise<void>;
+declare function waitForNextEpoch(timeoutMs?: number, pollIntervalMs?: number): Promise<string>;
+
+export { ADMIN_KEYPAIR, CLOCK_ID, Coin, Config, type ConfigVars, DENY_LIST_ID, MoveType, PublishSingleton, STATIC_CONFIGS, SuiClient, USDC, analyze_cost, createFundedWallet, createWallet, deploy, getDeployBytes, getKeypair, sleep, waitForNextEpoch };

package/dist/index.d.ts

@@ -0,0 +1,118 @@
+import { Keypair } from '@mysten/sui/cryptography';
+import { Transaction } from '@mysten/sui/transactions';
+import * as _mysten_sui_client from '@mysten/sui/client';
+import { SuiTransactionBlockResponse, SuiObjectChangePublished, SuiObjectChangeCreated, SuiClient as SuiClient$1 } from '@mysten/sui/client';
+import { Ed25519Keypair } from '@mysten/sui/keypairs/ed25519';
+
+declare const DENY_LIST_ID = "0x403";
+declare const CLOCK_ID = "0x6";
+type Network = 'mainnet' | 'testnet' | 'devnet' | 'localnet';
+interface ConfigVars {
+    NETWORK: Network;
+    RPC: string;
+    PACKAGE_PATH: string;
+    PACKAGE_ID: string;
+    UPGRADE_CAP_ID: string;
+    USDC_PACKAGE_ID?: string;
+    USDC_TREASURY_CAP?: string;
+}
+declare const ADMIN_KEYPAIR: Keypair;
+declare class Config {
+    private static instance;
+    private static getInstance;
+    get env(): Network;
+    static get vars(): ConfigVars;
+    static write(config: ConfigVars): string;
+}
+
+declare const STATIC_CONFIGS: any;
+
+declare class Coin {
+    static get coinType(): string;
+    static getBalance(owner: string): Promise<bigint>;
+    static getCoin(owner: Keypair, amount?: bigint): Promise<string>;
+    static _mint(treasuryId: string, amount: bigint, minter: Keypair): Promise<void>;
+    static send(amount: bigint, from: Keypair, to: string): Promise<void>;
+    static assertBalance(wallet: Keypair, amount: bigint | BigInt): Promise<void>;
+}
+
+declare class USDC extends Coin {
+    static get coinType(): string;
+    private static getMintCapId;
+    static faucet(amount: bigint, receiver: string, admin: Keypair): Promise<void>;
+}
+
+declare function analyze_cost(ptb: Transaction, resp: SuiTransactionBlockResponse): void;
+
+declare function deploy(vars?: ConfigVars): Promise<string>;
+declare function getDeployBytes(): Promise<string>;
+
+declare function getKeypair(privkey: string): Keypair;
+
+declare class PublishSingleton {
+    private readonly publishResp;
+    private static instance;
+    private constructor();
+    private static getDeployVars;
+    static publish(signer?: Keypair, packagePath?: string): Promise<void>;
+    private static getInstance;
+    static publishResponse(): SuiTransactionBlockResponse;
+    static get packageId(): string;
+    private static findObjectIdByType;
+    static get upgradeCapId(): string;
+    static get usdcTreasuryCap(): string;
+    static getPublishTx(packagePath: string, signer: Keypair): Transaction;
+    static getPublishBytes(signer?: Keypair, packagePath?: string): Promise<string>;
+    static publishPackage(signer: Keypair, packagePath: string): Promise<SuiTransactionBlockResponse>;
+    static findPublishedPackage(resp: SuiTransactionBlockResponse): SuiObjectChangePublished | undefined;
+    static findObjectChangeCreatedByType(resp: SuiTransactionBlockResponse, type: string): SuiObjectChangeCreated | undefined;
+}
+
+declare enum MoveType {
+    u8 = 0,
+    u16 = 1,
+    u32 = 2,
+    u64 = 3,
+    u128 = 4,
+    u256 = 5,
+    bool = 6,
+    string = 7,
+    object = 8,
+    address = 9,
+    address_opt = 10,
+    vec_address = 11
+}
+declare class SuiClient {
+    private static instance;
+    private client;
+    private constructor();
+    private static getInstance;
+    static get client(): SuiClient$1;
+    static signAndExecute(ptb: Transaction, signer: Keypair, errorHandler?: (e: any) => string): Promise<_mysten_sui_client.SuiTransactionBlockResponse>;
+    static toMoveArg(ptb: Transaction, value: any, type?: MoveType): any;
+    static moveCall({ signer, target, typeArgs, args, argTypes, errorHandler, ptb, withTransfer, }: {
+        signer: Keypair;
+        target: string;
+        typeArgs?: string[];
+        args?: any[];
+        argTypes?: MoveType[];
+        errorHandler?: (e: any) => string;
+        ptb?: Transaction;
+        withTransfer?: boolean;
+    }): Promise<_mysten_sui_client.SuiTransactionBlockResponse>;
+    static public_transfer(objects: string[], from: Keypair, to: string): Promise<_mysten_sui_client.SuiTransactionBlockResponse>;
+    static devInspect(ptb: Transaction, sender: string): Promise<_mysten_sui_client.DevInspectResults>;
+    static devInspectRaw(ptb: Transaction, sender: string): Promise<number[] | undefined>;
+    static devInspectBool(ptb: Transaction, sender: string): Promise<boolean | undefined>;
+    static devInspectU64(ptb: Transaction, sender: string): Promise<bigint>;
+    static devInspectAddress(ptb: Transaction, sender: string): Promise<string | undefined>;
+    static getObject(id: string): Promise<_mysten_sui_client.SuiObjectResponse>;
+    static getObjectsByType(owner: string, type: string): Promise<(string | undefined)[]>;
+}
+
+declare function createWallet(): Ed25519Keypair;
+declare function createFundedWallet(usdcAmount?: bigint): Promise<Ed25519Keypair>;
+declare function sleep(ms: number): Promise<void>;
+declare function waitForNextEpoch(timeoutMs?: number, pollIntervalMs?: number): Promise<string>;
+
+export { ADMIN_KEYPAIR, CLOCK_ID, Coin, Config, type ConfigVars, DENY_LIST_ID, MoveType, PublishSingleton, STATIC_CONFIGS, SuiClient, USDC, analyze_cost, createFundedWallet, createWallet, deploy, getDeployBytes, getKeypair, sleep, waitForNextEpoch };