@alien_org/contract 0.2.4 → 1.0.0-alpha.2

package/README.md

@@ -63,7 +63,7 @@ isMethodSupported('payment:request', '0.0.9');   // false
 
 // Get minimum version that supports a method
 getMethodMinVersion('app:ready');         // '0.0.9'
-getMethodMinVersion('payment:request');   // '0.0.14'
+getMethodMinVersion('payment:request');   // '0.1.1'
 
 // Get version where a method was introduced
 getReleaseVersion('app:ready');           // '0.0.9'
@@ -74,17 +74,33 @@ getReleaseVersion('app:ready');           // '0.0.9'
 | Method | Since | Description |
 |--------|-------|-------------|
 | `app:ready` | 0.0.9 | Notify host that miniapp is ready |
-| `miniapp:close.ack` | 0.0.14 | Acknowledge close request |
-| `host.back.button:toggle` | 0.0.14 | Show/hide back button |
-| `payment:request` | 0.0.14 | Request payment |
+| `payment:request` | 0.1.1 | Request payment |
+| `clipboard:write` | 0.1.1 | Write text to clipboard |
+| `clipboard:read` | 0.1.1 | Read text from clipboard |
+| `link:open` | 0.1.3 | Open a URL |
+| `haptic:impact` | 0.2.4 | Trigger haptic impact feedback |
+| `haptic:notification` | 0.2.4 | Trigger haptic notification feedback |
+| `haptic:selection` | 0.2.4 | Trigger haptic selection feedback |
+| `wallet.solana:connect` | 1.0.0 | Request Solana wallet connection |
+| `wallet.solana:disconnect` | 1.0.0 | Disconnect from Solana wallet |
+| `wallet.solana:sign.transaction` | 1.0.0 | Sign a Solana transaction |
+| `wallet.solana:sign.message` | 1.0.0 | Sign a Solana message |
+| `wallet.solana:sign.send` | 1.0.0 | Sign and send a Solana transaction |
+| `app:close` | 1.0.0 | Request host to close the miniapp |
+| `host.back.button:toggle` | 1.0.0 | Show/hide back button |
 
 ## Available Events
 
 | Event | Since | Description |
 |-------|-------|-------------|
 | `miniapp:close` | 0.0.14 | Host is closing miniapp |
-| `host.back.button:clicked` | 0.0.14 | Back button was clicked |
-| `payment:response` | 0.0.14 | Payment result |
+| `host.back.button:clicked` | 1.0.0 | Back button was clicked |
+| `payment:response` | 0.1.1 | Payment result |
+| `clipboard:response` | 0.1.1 | Clipboard read result |
+| `wallet.solana:connect.response` | 1.0.0 | Wallet connection result |
+| `wallet.solana:sign.transaction.response` | 1.0.0 | Transaction signing result |
+| `wallet.solana:sign.message.response` | 1.0.0 | Message signing result |
+| `wallet.solana:sign.send.response` | 1.0.0 | Sign and send result |
 
 ## LaunchParams
 
@@ -92,11 +108,13 @@ Parameters injected by the host app:
 
 ```typescript
 interface LaunchParams {
-  authToken: string | undefined;        // JWT auth token
-  contractVersion: Version | undefined; // Host's contract version
-  hostAppVersion: string | undefined;   // Host app version
-  platform: Platform | undefined;       // 'ios' | 'android'
-  startParam: string | undefined;       // Custom param (referrals, etc.)
+  authToken: string | undefined;           // JWT auth token
+  contractVersion: Version | undefined;    // Host's contract version
+  hostAppVersion: string | undefined;      // Host app version
+  platform: Platform | undefined;          // 'ios' | 'android'
+  safeAreaInsets: SafeAreaInsets | undefined; // System UI insets (CSS px)
+  startParam: string | undefined;          // Custom param (referrals, etc.)
+  isFullscreen: boolean | undefined;       // Launched in fullscreen mode
 }
 ```
 

package/dist/index.cjs

@@ -9,7 +9,6 @@ const PLATFORMS = ["ios", "android"];
 //#region src/methods/versions/releases.ts
 const releases = {
 	"0.0.9": ["app:ready"],
-	"0.0.14": ["miniapp:close.ack", "host.back.button:toggle"],
 	"0.1.1": [
 		"payment:request",
 		"clipboard:write",
@@ -20,6 +19,15 @@ const releases = {
 		"haptic:impact",
 		"haptic:notification",
 		"haptic:selection"
+	],
+	"1.0.0": [
+		"wallet.solana:connect",
+		"wallet.solana:disconnect",
+		"wallet.solana:sign.transaction",
+		"wallet.solana:sign.message",
+		"wallet.solana:sign.send",
+		"app:close",
+		"host.back.button:toggle"
 	]
 };
 
@@ -83,8 +91,32 @@ function getMethodMinVersion(method) {
 	}
 }
 
+//#endregion
+//#region src/utils.ts
+/**
+* Named constants for {@link WalletSolanaErrorCode}.
+*
+* @example
+* ```ts
+* import { WALLET_ERROR } from '@alien_org/contract';
+*
+* if (response.errorCode === WALLET_ERROR.USER_REJECTED) {
+*   // user cancelled
+* }
+* ```
+*
+* @since 1.0.0
+*/
+const WALLET_ERROR = {
+	USER_REJECTED: 5e3,
+	INVALID_PARAMS: -32602,
+	INTERNAL_ERROR: -32603,
+	REQUEST_EXPIRED: 8e3
+};
+
 //#endregion
 exports.PLATFORMS = PLATFORMS;
+exports.WALLET_ERROR = WALLET_ERROR;
 exports.getMethodMinVersion = getMethodMinVersion;
 exports.getReleaseVersion = getReleaseVersion;
 exports.isMethodSupported = isMethodSupported;

package/dist/index.d.cts

@@ -102,6 +102,62 @@ type HapticImpactStyle = 'light' | 'medium' | 'heavy' | 'soft' | 'rigid';
  * @schema
  */
 type HapticNotificationType = 'success' | 'warning' | 'error';
+/**
+ * Solana wallet error codes (WalletConnect-compatible numeric codes).
+ *
+ * These codes are identical to WalletConnect JSON-RPC error codes,
+ * so the mobile app produces the same `(code, message)` pair for
+ * both bridge and relay transports — no mapping needed.
+ *
+ * | Code | Meaning | WC Name |
+ * |------|---------|---------|
+ * | `5000` | User rejected the request | `userRejected` |
+ * | `-32602` | Invalid params (malformed transaction, bad input) | JSON-RPC standard |
+ * | `-32603` | Internal error (send failed, unexpected error) | JSON-RPC standard |
+ * | `8000` | Request expired / timed out | `sessionRequestExpired` |
+ *
+ * @since 1.0.0
+ * @schema
+ */
+type WalletSolanaErrorCode = 5000 | -32602 | -32603 | 8000;
+/**
+ * Named constants for {@link WalletSolanaErrorCode}.
+ *
+ * @example
+ * ```ts
+ * import { WALLET_ERROR } from '@alien_org/contract';
+ *
+ * if (response.errorCode === WALLET_ERROR.USER_REJECTED) {
+ *   // user cancelled
+ * }
+ * ```
+ *
+ * @since 1.0.0
+ */
+declare const WALLET_ERROR: {
+  /** User rejected the request (cancelled approval screen). */
+  readonly USER_REJECTED: 5000;
+  /** Invalid params — transaction deserialization failed, malformed input. */
+  readonly INVALID_PARAMS: -32602;
+  /** Internal error — transaction broadcast failed, unexpected error. */
+  readonly INTERNAL_ERROR: -32603;
+  /** Request expired before the user responded. */
+  readonly REQUEST_EXPIRED: 8000;
+};
+/**
+ * Solana commitment levels for send options.
+ * @since 1.0.0
+ * @schema
+ */
+type SolanaCommitment = 'processed' | 'confirmed' | 'finalized';
+/**
+ * Solana chain identifiers (wallet-standard format).
+ * Used by `wallet.solana:sign.send` to tell the host app
+ * which cluster to broadcast to.
+ * @since 1.0.0
+ * @schema
+ */
+type SolanaChain = 'solana:mainnet' | 'solana:devnet' | 'solana:testnet';
 //#endregion
 //#region src/events/types/payload.d.ts
 /**
@@ -126,7 +182,7 @@ interface Events {
   'miniapp:close': CreateEventPayload<Empty>;
   /**
    * Host app's back button clicked event.
-   * @since 0.0.14
+   * @since 1.0.0
    * @schema
    */
   'host.back.button:clicked': CreateEventPayload<Empty>;
@@ -195,6 +251,60 @@ interface Events {
      */
     errorCode?: 'permission_denied' | 'unavailable';
   }>>;
+  /**
+   * Solana wallet connection response.
+   * @since 1.0.0
+   * @schema
+   */
+  'wallet.solana:connect.response': CreateEventPayload<WithReqId<{
+    /** Base58-encoded public key of the connected wallet */
+    publicKey?: string;
+    /** Numeric error code (WalletConnect-compatible). See {@link WalletSolanaErrorCode}. */
+    errorCode?: WalletSolanaErrorCode;
+    /** Human-readable error description */
+    errorMessage?: string;
+  }>>;
+  /**
+   * Solana transaction signing response.
+   * @since 1.0.0
+   * @schema
+   */
+  'wallet.solana:sign.transaction.response': CreateEventPayload<WithReqId<{
+    /** Base64-encoded signed transaction */
+    signedTransaction?: string;
+    /** Numeric error code (WalletConnect-compatible). See {@link WalletSolanaErrorCode}. */
+    errorCode?: WalletSolanaErrorCode;
+    /** Human-readable error description */
+    errorMessage?: string;
+  }>>;
+  /**
+   * Solana message signing response.
+   * @since 1.0.0
+   * @schema
+   */
+  'wallet.solana:sign.message.response': CreateEventPayload<WithReqId<{
+    /** Base58-encoded Ed25519 signature (64 bytes) */
+    signature?: string;
+    /** Base58-encoded public key that signed the message */
+    publicKey?: string;
+    /** Numeric error code (WalletConnect-compatible). See {@link WalletSolanaErrorCode}. */
+    errorCode?: WalletSolanaErrorCode;
+    /** Human-readable error description */
+    errorMessage?: string;
+  }>>;
+  /**
+   * Solana sign-and-send transaction response.
+   * @since 1.0.0
+   * @schema
+   */
+  'wallet.solana:sign.send.response': CreateEventPayload<WithReqId<{
+    /** Base58-encoded transaction signature */
+    signature?: string;
+    /** Numeric error code (WalletConnect-compatible). See {@link WalletSolanaErrorCode}. */
+    errorCode?: WalletSolanaErrorCode;
+    /** Human-readable error description */
+    errorMessage?: string;
+  }>>;
 }
 //#endregion
 //#region src/events/types/event-types.d.ts
@@ -239,6 +349,11 @@ interface LaunchParams {
    * Used for referral codes, campaign tracking, or custom routing.
    */
   startParam: string | undefined;
+  /**
+   * Whether the miniapp was launched in fullscreen mode.
+   * @since 1.0.0
+   */
+  isFullscreen: boolean | undefined;
 }
 //#endregion
 //#region src/methods/types/payload.d.ts
@@ -259,27 +374,27 @@ interface Methods {
   /**
    * Miniapp ready method.
    * Sent by the miniapp to notify the host app that it has loaded and is ready to be displayed.
-   * @since 0.0.1
+   * @since 0.0.9
    * @schema
    */
   'app:ready': CreateMethodPayload<Empty>;
   /**
-   * Miniapp close acknowledgment method.
-   * Sent by the miniapp to notify the host app that it has completed cleanup and is ready to be closed.
-   * Note that if the miniapp takes longer than 10 seconds to close, the host app will force close the miniapp.
-   * @since 0.0.14
+   * Close the miniapp.
+   * Sent by the miniapp to request the host app to close it.
+   * Fire-and-forget — no response expected.
+   * @since 1.0.0
    * @schema
    */
-  'miniapp:close.ack': CreateMethodPayload<Empty>;
+  'app:close': CreateMethodPayload<Empty>;
   /**
    * Toggle host app's back button visibility.
-   * @since 0.0.14
+   * @since 1.0.0
    * @schema
    */
   'host.back.button:toggle': CreateMethodPayload<{
     /**
      * Whether to show or hide the back button.
-     * @since 0.0.14
+     * @since 1.0.0
      * @schema
      */
     visible: boolean;
@@ -291,8 +406,8 @@ interface Methods {
    * Your backend receives a webhook when user pays - fulfill the order
    * immediately without waiting for chain confirmation.
    *
-   * Optional display fields (`title`, `caption`, `iconUrl`, `quantity`)
-   * are shown on the payment approval screen.
+   * Optional `item` object (`title`, `iconUrl`, `quantity`)
+   * is shown on the payment approval screen.
    *
    * Set `test` to a scenario string (e.g. `'paid'`, `'error:insufficient_balance'`)
    * for test mode - no real payment is made, but the specified scenario is
@@ -481,6 +596,73 @@ interface Methods {
    * @schema
    */
   'haptic:selection': CreateMethodPayload<Empty>;
+  /**
+   * Request Solana wallet connection.
+   * Returns the wallet's public key on success.
+   * @since 1.0.0
+   * @schema
+   */
+  'wallet.solana:connect': CreateMethodPayload<WithReqId<Empty>>;
+  /**
+   * Disconnect from Solana wallet.
+   * Fire-and-forget — no response expected.
+   * @since 1.0.0
+   * @schema
+   */
+  'wallet.solana:disconnect': CreateMethodPayload<Empty>;
+  /**
+   * Request Solana transaction signing.
+   * Returns the signed transaction bytes.
+   * @since 1.0.0
+   * @schema
+   */
+  'wallet.solana:sign.transaction': CreateMethodPayload<WithReqId<{
+    /** Base64-encoded serialized transaction (legacy or versioned) */
+    transaction: string;
+  }>>;
+  /**
+   * Request Solana message signing.
+   * Returns the Ed25519 signature.
+   * @since 1.0.0
+   * @schema
+   */
+  'wallet.solana:sign.message': CreateMethodPayload<WithReqId<{
+    /** Base58-encoded message bytes */
+    message: string;
+  }>>;
+  /**
+   * Request Solana transaction signing and sending.
+   * The host app signs and broadcasts the transaction.
+   * Returns the transaction signature.
+   * @since 1.0.0
+   * @schema
+   */
+  'wallet.solana:sign.send': CreateMethodPayload<WithReqId<{
+    /** Base64-encoded serialized transaction (legacy or versioned) */
+    transaction: string;
+    /**
+     * Target Solana cluster for broadcasting.
+     * In bridge mode the host app can infer this from miniapp config,
+     * but in relay mode (QR/WebSocket) this is required so the host
+     * app knows which RPC to broadcast to.
+     * @since 1.0.0
+     * @schema
+     */
+    chain?: SolanaChain;
+    /** Optional send options */
+    options?: {
+      skipPreflight?: boolean;
+      preflightCommitment?: SolanaCommitment;
+      /** Desired commitment level for transaction confirmation. */
+      commitment?: SolanaCommitment;
+      /**
+       * The minimum slot that the request can be evaluated at.
+       * Ensures the read is not served by a node lagging behind.
+       */
+      minContextSlot?: number;
+      maxRetries?: number;
+    };
+  }>>;
 }
 //#endregion
 //#region src/methods/types/method-types.d.ts
@@ -535,4 +717,4 @@ declare function isMethodSupported(method: MethodName, version: Version): boolea
  */
 declare function getMethodMinVersion(method: MethodName): Version | undefined;
 //#endregion
-export { type CreateEventPayload, type CreateMethodPayload, type EventName, type EventPayload, type Events, type HapticImpactStyle, type HapticNotificationType, type LaunchParams, type MethodName, type MethodNameWithVersionedPayload, type MethodPayload, type MethodVersionedPayload, type Methods, PLATFORMS, type PaymentErrorCode, type PaymentTestScenario, type PaymentWebhookStatus, type Platform, type SafeAreaInsets, type Version, getMethodMinVersion, getReleaseVersion, isMethodSupported, releases };
+export { type CreateEventPayload, type CreateMethodPayload, type EventName, type EventPayload, type Events, type HapticImpactStyle, type HapticNotificationType, type LaunchParams, type MethodName, type MethodNameWithVersionedPayload, type MethodPayload, type MethodVersionedPayload, type Methods, PLATFORMS, type PaymentErrorCode, type PaymentTestScenario, type PaymentWebhookStatus, type Platform, type SafeAreaInsets, type SolanaChain, type SolanaCommitment, type Version, WALLET_ERROR, type WalletSolanaErrorCode, getMethodMinVersion, getReleaseVersion, isMethodSupported, releases };

package/dist/index.d.mts

@@ -102,6 +102,62 @@ type HapticImpactStyle = 'light' | 'medium' | 'heavy' | 'soft' | 'rigid';
  * @schema
  */
 type HapticNotificationType = 'success' | 'warning' | 'error';
+/**
+ * Solana wallet error codes (WalletConnect-compatible numeric codes).
+ *
+ * These codes are identical to WalletConnect JSON-RPC error codes,
+ * so the mobile app produces the same `(code, message)` pair for
+ * both bridge and relay transports — no mapping needed.
+ *
+ * | Code | Meaning | WC Name |
+ * |------|---------|---------|
+ * | `5000` | User rejected the request | `userRejected` |
+ * | `-32602` | Invalid params (malformed transaction, bad input) | JSON-RPC standard |
+ * | `-32603` | Internal error (send failed, unexpected error) | JSON-RPC standard |
+ * | `8000` | Request expired / timed out | `sessionRequestExpired` |
+ *
+ * @since 1.0.0
+ * @schema
+ */
+type WalletSolanaErrorCode = 5000 | -32602 | -32603 | 8000;
+/**
+ * Named constants for {@link WalletSolanaErrorCode}.
+ *
+ * @example
+ * ```ts
+ * import { WALLET_ERROR } from '@alien_org/contract';
+ *
+ * if (response.errorCode === WALLET_ERROR.USER_REJECTED) {
+ *   // user cancelled
+ * }
+ * ```
+ *
+ * @since 1.0.0
+ */
+declare const WALLET_ERROR: {
+  /** User rejected the request (cancelled approval screen). */
+  readonly USER_REJECTED: 5000;
+  /** Invalid params — transaction deserialization failed, malformed input. */
+  readonly INVALID_PARAMS: -32602;
+  /** Internal error — transaction broadcast failed, unexpected error. */
+  readonly INTERNAL_ERROR: -32603;
+  /** Request expired before the user responded. */
+  readonly REQUEST_EXPIRED: 8000;
+};
+/**
+ * Solana commitment levels for send options.
+ * @since 1.0.0
+ * @schema
+ */
+type SolanaCommitment = 'processed' | 'confirmed' | 'finalized';
+/**
+ * Solana chain identifiers (wallet-standard format).
+ * Used by `wallet.solana:sign.send` to tell the host app
+ * which cluster to broadcast to.
+ * @since 1.0.0
+ * @schema
+ */
+type SolanaChain = 'solana:mainnet' | 'solana:devnet' | 'solana:testnet';
 //#endregion
 //#region src/events/types/payload.d.ts
 /**
@@ -126,7 +182,7 @@ interface Events {
   'miniapp:close': CreateEventPayload<Empty>;
   /**
    * Host app's back button clicked event.
-   * @since 0.0.14
+   * @since 1.0.0
    * @schema
    */
   'host.back.button:clicked': CreateEventPayload<Empty>;
@@ -195,6 +251,60 @@ interface Events {
      */
     errorCode?: 'permission_denied' | 'unavailable';
   }>>;
+  /**
+   * Solana wallet connection response.
+   * @since 1.0.0
+   * @schema
+   */
+  'wallet.solana:connect.response': CreateEventPayload<WithReqId<{
+    /** Base58-encoded public key of the connected wallet */
+    publicKey?: string;
+    /** Numeric error code (WalletConnect-compatible). See {@link WalletSolanaErrorCode}. */
+    errorCode?: WalletSolanaErrorCode;
+    /** Human-readable error description */
+    errorMessage?: string;
+  }>>;
+  /**
+   * Solana transaction signing response.
+   * @since 1.0.0
+   * @schema
+   */
+  'wallet.solana:sign.transaction.response': CreateEventPayload<WithReqId<{
+    /** Base64-encoded signed transaction */
+    signedTransaction?: string;
+    /** Numeric error code (WalletConnect-compatible). See {@link WalletSolanaErrorCode}. */
+    errorCode?: WalletSolanaErrorCode;
+    /** Human-readable error description */
+    errorMessage?: string;
+  }>>;
+  /**
+   * Solana message signing response.
+   * @since 1.0.0
+   * @schema
+   */
+  'wallet.solana:sign.message.response': CreateEventPayload<WithReqId<{
+    /** Base58-encoded Ed25519 signature (64 bytes) */
+    signature?: string;
+    /** Base58-encoded public key that signed the message */
+    publicKey?: string;
+    /** Numeric error code (WalletConnect-compatible). See {@link WalletSolanaErrorCode}. */
+    errorCode?: WalletSolanaErrorCode;
+    /** Human-readable error description */
+    errorMessage?: string;
+  }>>;
+  /**
+   * Solana sign-and-send transaction response.
+   * @since 1.0.0
+   * @schema
+   */
+  'wallet.solana:sign.send.response': CreateEventPayload<WithReqId<{
+    /** Base58-encoded transaction signature */
+    signature?: string;
+    /** Numeric error code (WalletConnect-compatible). See {@link WalletSolanaErrorCode}. */
+    errorCode?: WalletSolanaErrorCode;
+    /** Human-readable error description */
+    errorMessage?: string;
+  }>>;
 }
 //#endregion
 //#region src/events/types/event-types.d.ts
@@ -239,6 +349,11 @@ interface LaunchParams {
    * Used for referral codes, campaign tracking, or custom routing.
    */
   startParam: string | undefined;
+  /**
+   * Whether the miniapp was launched in fullscreen mode.
+   * @since 1.0.0
+   */
+  isFullscreen: boolean | undefined;
 }
 //#endregion
 //#region src/methods/types/payload.d.ts
@@ -259,27 +374,27 @@ interface Methods {
   /**
    * Miniapp ready method.
    * Sent by the miniapp to notify the host app that it has loaded and is ready to be displayed.
-   * @since 0.0.1
+   * @since 0.0.9
    * @schema
    */
   'app:ready': CreateMethodPayload<Empty>;
   /**
-   * Miniapp close acknowledgment method.
-   * Sent by the miniapp to notify the host app that it has completed cleanup and is ready to be closed.
-   * Note that if the miniapp takes longer than 10 seconds to close, the host app will force close the miniapp.
-   * @since 0.0.14
+   * Close the miniapp.
+   * Sent by the miniapp to request the host app to close it.
+   * Fire-and-forget — no response expected.
+   * @since 1.0.0
    * @schema
    */
-  'miniapp:close.ack': CreateMethodPayload<Empty>;
+  'app:close': CreateMethodPayload<Empty>;
   /**
    * Toggle host app's back button visibility.
-   * @since 0.0.14
+   * @since 1.0.0
    * @schema
    */
   'host.back.button:toggle': CreateMethodPayload<{
     /**
      * Whether to show or hide the back button.
-     * @since 0.0.14
+     * @since 1.0.0
      * @schema
      */
     visible: boolean;
@@ -291,8 +406,8 @@ interface Methods {
    * Your backend receives a webhook when user pays - fulfill the order
    * immediately without waiting for chain confirmation.
    *
-   * Optional display fields (`title`, `caption`, `iconUrl`, `quantity`)
-   * are shown on the payment approval screen.
+   * Optional `item` object (`title`, `iconUrl`, `quantity`)
+   * is shown on the payment approval screen.
    *
    * Set `test` to a scenario string (e.g. `'paid'`, `'error:insufficient_balance'`)
    * for test mode - no real payment is made, but the specified scenario is
@@ -481,6 +596,73 @@ interface Methods {
    * @schema
    */
   'haptic:selection': CreateMethodPayload<Empty>;
+  /**
+   * Request Solana wallet connection.
+   * Returns the wallet's public key on success.
+   * @since 1.0.0
+   * @schema
+   */
+  'wallet.solana:connect': CreateMethodPayload<WithReqId<Empty>>;
+  /**
+   * Disconnect from Solana wallet.
+   * Fire-and-forget — no response expected.
+   * @since 1.0.0
+   * @schema
+   */
+  'wallet.solana:disconnect': CreateMethodPayload<Empty>;
+  /**
+   * Request Solana transaction signing.
+   * Returns the signed transaction bytes.
+   * @since 1.0.0
+   * @schema
+   */
+  'wallet.solana:sign.transaction': CreateMethodPayload<WithReqId<{
+    /** Base64-encoded serialized transaction (legacy or versioned) */
+    transaction: string;
+  }>>;
+  /**
+   * Request Solana message signing.
+   * Returns the Ed25519 signature.
+   * @since 1.0.0
+   * @schema
+   */
+  'wallet.solana:sign.message': CreateMethodPayload<WithReqId<{
+    /** Base58-encoded message bytes */
+    message: string;
+  }>>;
+  /**
+   * Request Solana transaction signing and sending.
+   * The host app signs and broadcasts the transaction.
+   * Returns the transaction signature.
+   * @since 1.0.0
+   * @schema
+   */
+  'wallet.solana:sign.send': CreateMethodPayload<WithReqId<{
+    /** Base64-encoded serialized transaction (legacy or versioned) */
+    transaction: string;
+    /**
+     * Target Solana cluster for broadcasting.
+     * In bridge mode the host app can infer this from miniapp config,
+     * but in relay mode (QR/WebSocket) this is required so the host
+     * app knows which RPC to broadcast to.
+     * @since 1.0.0
+     * @schema
+     */
+    chain?: SolanaChain;
+    /** Optional send options */
+    options?: {
+      skipPreflight?: boolean;
+      preflightCommitment?: SolanaCommitment;
+      /** Desired commitment level for transaction confirmation. */
+      commitment?: SolanaCommitment;
+      /**
+       * The minimum slot that the request can be evaluated at.
+       * Ensures the read is not served by a node lagging behind.
+       */
+      minContextSlot?: number;
+      maxRetries?: number;
+    };
+  }>>;
 }
 //#endregion
 //#region src/methods/types/method-types.d.ts
@@ -535,4 +717,4 @@ declare function isMethodSupported(method: MethodName, version: Version): boolea
  */
 declare function getMethodMinVersion(method: MethodName): Version | undefined;
 //#endregion
-export { type CreateEventPayload, type CreateMethodPayload, type EventName, type EventPayload, type Events, type HapticImpactStyle, type HapticNotificationType, type LaunchParams, type MethodName, type MethodNameWithVersionedPayload, type MethodPayload, type MethodVersionedPayload, type Methods, PLATFORMS, type PaymentErrorCode, type PaymentTestScenario, type PaymentWebhookStatus, type Platform, type SafeAreaInsets, type Version, getMethodMinVersion, getReleaseVersion, isMethodSupported, releases };
+export { type CreateEventPayload, type CreateMethodPayload, type EventName, type EventPayload, type Events, type HapticImpactStyle, type HapticNotificationType, type LaunchParams, type MethodName, type MethodNameWithVersionedPayload, type MethodPayload, type MethodVersionedPayload, type Methods, PLATFORMS, type PaymentErrorCode, type PaymentTestScenario, type PaymentWebhookStatus, type Platform, type SafeAreaInsets, type SolanaChain, type SolanaCommitment, type Version, WALLET_ERROR, type WalletSolanaErrorCode, getMethodMinVersion, getReleaseVersion, isMethodSupported, releases };

package/dist/index.mjs

@@ -8,7 +8,6 @@ const PLATFORMS = ["ios", "android"];
 //#region src/methods/versions/releases.ts
 const releases = {
 	"0.0.9": ["app:ready"],
-	"0.0.14": ["miniapp:close.ack", "host.back.button:toggle"],
 	"0.1.1": [
 		"payment:request",
 		"clipboard:write",
@@ -19,6 +18,15 @@ const releases = {
 		"haptic:impact",
 		"haptic:notification",
 		"haptic:selection"
+	],
+	"1.0.0": [
+		"wallet.solana:connect",
+		"wallet.solana:disconnect",
+		"wallet.solana:sign.transaction",
+		"wallet.solana:sign.message",
+		"wallet.solana:sign.send",
+		"app:close",
+		"host.back.button:toggle"
 	]
 };
 
@@ -83,4 +91,27 @@ function getMethodMinVersion(method) {
 }
 
 //#endregion
-export { PLATFORMS, getMethodMinVersion, getReleaseVersion, isMethodSupported, releases };
+//#region src/utils.ts
+/**
+* Named constants for {@link WalletSolanaErrorCode}.
+*
+* @example
+* ```ts
+* import { WALLET_ERROR } from '@alien_org/contract';
+*
+* if (response.errorCode === WALLET_ERROR.USER_REJECTED) {
+*   // user cancelled
+* }
+* ```
+*
+* @since 1.0.0
+*/
+const WALLET_ERROR = {
+	USER_REJECTED: 5e3,
+	INVALID_PARAMS: -32602,
+	INTERNAL_ERROR: -32603,
+	REQUEST_EXPIRED: 8e3
+};
+
+//#endregion
+export { PLATFORMS, WALLET_ERROR, getMethodMinVersion, getReleaseVersion, isMethodSupported, releases };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alien_org/contract",
-  "version": "0.2.4",
+  "version": "1.0.0-alpha.2",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",