@qubic.org/contracts 0.2.7 → 1.0.1

package/src/call-contract.ts

@@ -0,0 +1,87 @@
+import type { BinaryField, FieldValue, NamedStruct } from '@qubic.org/registry'
+import { buildPayload, decodePayload } from '@qubic.org/registry'
+import type { QubicRpcError } from '@qubic.org/rpc'
+import type { QuerySmartContractRequest, QuerySmartContractResponse } from '@qubic.org/rpc'
+import type { Result } from '@qubic.org/rpc'
+import { ok } from '@qubic.org/types'
+
+export interface SmartContractCaller {
+  querySmartContract(
+    req: QuerySmartContractRequest,
+  ): Promise<Result<QuerySmartContractResponse, QubicRpcError>>
+}
+
+export interface ContractCallOptions {
+  identityToPublicKey?: (identity: string) => Uint8Array
+  publicKeyToIdentity?: (pk: Uint8Array) => string
+}
+
+/** Returned by builder functions — contains everything needed to send a contract call. */
+export interface ContractCall {
+  contractIndex: number
+  inputType: number
+  payload: Uint8Array
+}
+
+const _defaultIdToPk = (_identity: string): Uint8Array => {
+  throw new Error('identityToPublicKey is required for contracts with id-type fields')
+}
+const _defaultPkToId = (_pk: Uint8Array): string => {
+  throw new Error('publicKeyToIdentity is required for contracts with id-type fields')
+}
+
+function toBase64(bytes: Uint8Array): string {
+  let s = ''
+  for (let i = 0; i < bytes.length; i++) s += String.fromCharCode(bytes[i] ?? 0)
+  return btoa(s)
+}
+
+function fromBase64(b64: string): Uint8Array {
+  const s = atob(b64)
+  const out = new Uint8Array(s.length)
+  for (let i = 0; i < s.length; i++) out[i] = s.charCodeAt(i)
+  return out
+}
+
+export interface CallContractFunctionOptions<TInput extends Record<string, unknown>> {
+  live: SmartContractCaller
+  contractIndex: number
+  inputType: number
+  inputSize: number
+  inputFields: BinaryField[]
+  outputFields: BinaryField[]
+  structs: Record<string, NamedStruct>
+  input: TInput
+  identityToPublicKey?: (identity: string) => Uint8Array
+  publicKeyToIdentity?: (pk: Uint8Array) => string
+}
+
+export async function callContractFunction<TInput extends Record<string, unknown>, TOutput>(
+  options: CallContractFunctionOptions<TInput>,
+): Promise<Result<TOutput, QubicRpcError>> {
+  const idToPk = options.identityToPublicKey ?? _defaultIdToPk
+  const pkToId = options.publicKeyToIdentity ?? _defaultPkToId
+  // buildPayload / decodePayload throw PayloadBuildError on bad input — those are
+  // programmer errors and must not be swallowed as QubicRpcError.
+  const payload = buildPayload(
+    options.inputFields,
+    options.structs,
+    options.input as Record<string, FieldValue | Uint8Array>,
+    idToPk,
+  )
+  const r = await options.live.querySmartContract({
+    contractIndex: options.contractIndex,
+    inputType: options.inputType,
+    inputSize: options.inputSize,
+    requestData: toBase64(payload),
+  })
+  if (!r.ok) return r
+  const responseBytes = fromBase64(r.value.responseData ?? '')
+  const decoded = decodePayload(responseBytes, options.outputFields, options.structs, pkToId)
+  for (const field of options.outputFields) {
+    if (!(field.name in decoded)) {
+      throw new Error(`decoded response missing expected field "${field.name}"`)
+    }
+  }
+  return ok(decoded as unknown as TOutput)
+}

package/src/index.ts

@@ -0,0 +1,9 @@
+export type { Result, Ok, Err } from '@qubic.org/types'
+export { ok, err } from '@qubic.org/types'
+export type {
+  SmartContractCaller,
+  CallContractFunctionOptions,
+  ContractCall,
+} from './call-contract.js'
+export { callContractFunction } from './call-contract.js'
+export * from './__generated__/index.js'

package/dist/result.d.ts

@@ -1,12 +0,0 @@
-export type Ok<T> = {
-    readonly ok: true;
-    readonly value: T;
-};
-export type Err<E> = {
-    readonly ok: false;
-    readonly error: E;
-};
-export type Result<T, E> = Ok<T> | Err<E>;
-export declare function ok<T>(value: T): Ok<T>;
-export declare function err<E>(error: E): Err<E>;
-//# sourceMappingURL=result.d.ts.map

package/dist/result.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../src/result.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,EAAE,CAAC,CAAC,IAAI;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;CAAE,CAAA;AAC5D,MAAM,MAAM,GAAG,CAAC,CAAC,IAAI;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;CAAE,CAAA;AAC9D,MAAM,MAAM,MAAM,CAAC,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAA;AACzC,wBAAgB,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAErC;AACD,wBAAgB,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAEvC"}

package/dist/result.js

@@ -1,7 +0,0 @@
-export function ok(value) {
-    return { ok: true, value };
-}
-export function err(error) {
-    return { ok: false, error };
-}
-//# sourceMappingURL=result.js.map

package/dist/result.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"result.js","sourceRoot":"","sources":["../src/result.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,EAAE,CAAI,KAAQ;IAC5B,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAA;AAC5B,CAAC;AACD,MAAM,UAAU,GAAG,CAAI,KAAQ;IAC7B,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAA;AAC7B,CAAC"}