@alpha-arcade/sdk 0.2.11 → 0.3.1

package/dist/index.d.cts

@@ -1,4 +1,5 @@
-import algosdk, { Algodv2, Indexer, TransactionSigner } from 'algosdk';
+import * as algosdk from 'algosdk';
+import { Algodv2, Indexer, TransactionSigner } from 'algosdk';
 
 /** Configuration for initializing the AlphaClient */
 type AlphaClientConfig = {
@@ -146,6 +147,18 @@ type ProposeMatchParams = {
     /** Quantity to match in microunits */
     quantityMatched: number;
 };
+/**
+ * Parameters for matching two existing limit orders (e.g. after an amend).
+ * The taker is the order placed last and pays the fee; the maker is the counterparty.
+ */
+type ProcessMatchParams = {
+    /** Market app ID */
+    marketAppId: number;
+    /** Maker escrow app ID (existing order — was on the book first) */
+    makerEscrowAppId: number;
+    /** Taker escrow app ID (existing order — placed last, pays the fee) */
+    takerEscrowAppId: number;
+};
 /** Parameters for amending (editing) an existing unfilled order */
 type AmendOrderParams = {
     /** Market app ID */
@@ -201,6 +214,15 @@ type ProposeMatchResult = {
     /** Confirmed round number */
     confirmedRound: number;
 };
+/** Result of processing a match between two existing orders */
+type ProcessMatchResult = {
+    /** Whether the match succeeded */
+    success: boolean;
+    /** Transaction IDs */
+    txIds: string[];
+    /** Confirmed round number */
+    confirmedRound: number;
+};
 /** Result of amending an order */
 type AmendOrderResult = {
     /** Whether the amendment succeeded */
@@ -209,6 +231,10 @@ type AmendOrderResult = {
     txIds: string[];
     /** Confirmed round number */
     confirmedRound: number;
+    /** Total quantity matched against counterparty orders (if matching was performed) */
+    matchedQuantity?: number;
+    /** Volume-weighted average fill price in microunits (if any matches) */
+    matchedPrice?: number;
 };
 /** A single entry in the orderbook (one price level, one order) */
 type OrderbookEntry = {
@@ -360,7 +386,7 @@ type EscrowGlobalState = {
  *   algodClient,
  *   indexerClient,
  *   signer,
- *   activeAddress: account.addr,
+ *   activeAddress: account.addr.toString(),
  *   matcherAppId: 3078581851,
  *   usdcAssetId: 31566704,
  * });
@@ -422,6 +448,17 @@ declare class AlphaClient {
      * @returns Whether the match succeeded
      */
     proposeMatch(params: ProposeMatchParams): Promise<ProposeMatchResult>;
+    /**
+     * Matches two existing limit orders (no create-escrow in the group).
+     *
+     * Calls the market app's process_potential_match(maker, taker). Use this
+     * after amending an order: the amended order is the taker (pays the fee),
+     * the counterparty is the maker.
+     *
+     * @param params - Process match params (marketAppId, makerEscrowAppId, takerEscrowAppId)
+     * @returns Whether the match succeeded
+     */
+    processMatch(params: ProcessMatchParams): Promise<ProcessMatchResult>;
     /**
      * Amends (edits) an existing unfilled order in-place.
      *
@@ -651,6 +688,7 @@ declare const calculateMatchingOrders: (orderbook: Orderbook, isBuying: boolean,
 
 /**
  * Decodes raw Algorand global state array into a key-value object.
+ * Supports both v2 (kebab-case) and v3 (camelCase) response shapes.
  *
  * @param rawState - The raw global-state array from algod/indexer
  * @returns Decoded key-value object
@@ -682,4 +720,4 @@ declare const getEscrowGlobalState: (indexerClient: algosdk.Indexer, escrowAppId
  */
 declare const checkAssetOptIn: (algodClient: algosdk.Algodv2, address: string, assetId: number) => Promise<boolean>;
 
-export { type AggregatedOrderbook, type AggregatedOrderbookEntry, type AggregatedOrderbookSide, AlphaClient, type AlphaClientConfig, type AmendOrderParams, type AmendOrderResult, type CancelOrderParams, type CancelOrderResult, type ClaimParams, type ClaimResult, type CounterpartyMatch, type CreateLimitOrderParams, type CreateMarketOrderParams, type CreateOrderResult, DEFAULT_API_BASE_URL, DEFAULT_MARKET_CREATOR_ADDRESS, type EscrowGlobalState, type Market, type MarketGlobalState, type MarketOption, type MergeSharesParams, type OpenOrder, type OrderSide, type Orderbook, type OrderbookEntry, type OrderbookSide, type Position, type ProposeMatchParams, type ProposeMatchResult, type SplitMergeResult, type SplitSharesParams, type WalletPosition, calculateFee, calculateFeeFromTotal, calculateMatchingOrders, checkAssetOptIn, decodeGlobalState, getEscrowGlobalState, getLiveMarketsFromApi, getMarketFromApi, getMarketGlobalState, getMarketOnChain, getMarketsOnChain };
+export { type AggregatedOrderbook, type AggregatedOrderbookEntry, type AggregatedOrderbookSide, AlphaClient, type AlphaClientConfig, type AmendOrderParams, type AmendOrderResult, type CancelOrderParams, type CancelOrderResult, type ClaimParams, type ClaimResult, type CounterpartyMatch, type CreateLimitOrderParams, type CreateMarketOrderParams, type CreateOrderResult, DEFAULT_API_BASE_URL, DEFAULT_MARKET_CREATOR_ADDRESS, type EscrowGlobalState, type Market, type MarketGlobalState, type MarketOption, type MergeSharesParams, type OpenOrder, type OrderSide, type Orderbook, type OrderbookEntry, type OrderbookSide, type Position, type ProcessMatchParams, type ProcessMatchResult, type ProposeMatchParams, type ProposeMatchResult, type SplitMergeResult, type SplitSharesParams, type WalletPosition, calculateFee, calculateFeeFromTotal, calculateMatchingOrders, checkAssetOptIn, decodeGlobalState, getEscrowGlobalState, getLiveMarketsFromApi, getMarketFromApi, getMarketGlobalState, getMarketOnChain, getMarketsOnChain };

package/dist/index.d.ts

@@ -1,4 +1,5 @@
-import algosdk, { Algodv2, Indexer, TransactionSigner } from 'algosdk';
+import * as algosdk from 'algosdk';
+import { Algodv2, Indexer, TransactionSigner } from 'algosdk';
 
 /** Configuration for initializing the AlphaClient */
 type AlphaClientConfig = {
@@ -146,6 +147,18 @@ type ProposeMatchParams = {
     /** Quantity to match in microunits */
     quantityMatched: number;
 };
+/**
+ * Parameters for matching two existing limit orders (e.g. after an amend).
+ * The taker is the order placed last and pays the fee; the maker is the counterparty.
+ */
+type ProcessMatchParams = {
+    /** Market app ID */
+    marketAppId: number;
+    /** Maker escrow app ID (existing order — was on the book first) */
+    makerEscrowAppId: number;
+    /** Taker escrow app ID (existing order — placed last, pays the fee) */
+    takerEscrowAppId: number;
+};
 /** Parameters for amending (editing) an existing unfilled order */
 type AmendOrderParams = {
     /** Market app ID */
@@ -201,6 +214,15 @@ type ProposeMatchResult = {
     /** Confirmed round number */
     confirmedRound: number;
 };
+/** Result of processing a match between two existing orders */
+type ProcessMatchResult = {
+    /** Whether the match succeeded */
+    success: boolean;
+    /** Transaction IDs */
+    txIds: string[];
+    /** Confirmed round number */
+    confirmedRound: number;
+};
 /** Result of amending an order */
 type AmendOrderResult = {
     /** Whether the amendment succeeded */
@@ -209,6 +231,10 @@ type AmendOrderResult = {
     txIds: string[];
     /** Confirmed round number */
     confirmedRound: number;
+    /** Total quantity matched against counterparty orders (if matching was performed) */
+    matchedQuantity?: number;
+    /** Volume-weighted average fill price in microunits (if any matches) */
+    matchedPrice?: number;
 };
 /** A single entry in the orderbook (one price level, one order) */
 type OrderbookEntry = {
@@ -360,7 +386,7 @@ type EscrowGlobalState = {
  *   algodClient,
  *   indexerClient,
  *   signer,
- *   activeAddress: account.addr,
+ *   activeAddress: account.addr.toString(),
  *   matcherAppId: 3078581851,
  *   usdcAssetId: 31566704,
  * });
@@ -422,6 +448,17 @@ declare class AlphaClient {
      * @returns Whether the match succeeded
      */
     proposeMatch(params: ProposeMatchParams): Promise<ProposeMatchResult>;
+    /**
+     * Matches two existing limit orders (no create-escrow in the group).
+     *
+     * Calls the market app's process_potential_match(maker, taker). Use this
+     * after amending an order: the amended order is the taker (pays the fee),
+     * the counterparty is the maker.
+     *
+     * @param params - Process match params (marketAppId, makerEscrowAppId, takerEscrowAppId)
+     * @returns Whether the match succeeded
+     */
+    processMatch(params: ProcessMatchParams): Promise<ProcessMatchResult>;
     /**
      * Amends (edits) an existing unfilled order in-place.
      *
@@ -651,6 +688,7 @@ declare const calculateMatchingOrders: (orderbook: Orderbook, isBuying: boolean,
 
 /**
  * Decodes raw Algorand global state array into a key-value object.
+ * Supports both v2 (kebab-case) and v3 (camelCase) response shapes.
  *
  * @param rawState - The raw global-state array from algod/indexer
  * @returns Decoded key-value object
@@ -682,4 +720,4 @@ declare const getEscrowGlobalState: (indexerClient: algosdk.Indexer, escrowAppId
  */
 declare const checkAssetOptIn: (algodClient: algosdk.Algodv2, address: string, assetId: number) => Promise<boolean>;
 
-export { type AggregatedOrderbook, type AggregatedOrderbookEntry, type AggregatedOrderbookSide, AlphaClient, type AlphaClientConfig, type AmendOrderParams, type AmendOrderResult, type CancelOrderParams, type CancelOrderResult, type ClaimParams, type ClaimResult, type CounterpartyMatch, type CreateLimitOrderParams, type CreateMarketOrderParams, type CreateOrderResult, DEFAULT_API_BASE_URL, DEFAULT_MARKET_CREATOR_ADDRESS, type EscrowGlobalState, type Market, type MarketGlobalState, type MarketOption, type MergeSharesParams, type OpenOrder, type OrderSide, type Orderbook, type OrderbookEntry, type OrderbookSide, type Position, type ProposeMatchParams, type ProposeMatchResult, type SplitMergeResult, type SplitSharesParams, type WalletPosition, calculateFee, calculateFeeFromTotal, calculateMatchingOrders, checkAssetOptIn, decodeGlobalState, getEscrowGlobalState, getLiveMarketsFromApi, getMarketFromApi, getMarketGlobalState, getMarketOnChain, getMarketsOnChain };
+export { type AggregatedOrderbook, type AggregatedOrderbookEntry, type AggregatedOrderbookSide, AlphaClient, type AlphaClientConfig, type AmendOrderParams, type AmendOrderResult, type CancelOrderParams, type CancelOrderResult, type ClaimParams, type ClaimResult, type CounterpartyMatch, type CreateLimitOrderParams, type CreateMarketOrderParams, type CreateOrderResult, DEFAULT_API_BASE_URL, DEFAULT_MARKET_CREATOR_ADDRESS, type EscrowGlobalState, type Market, type MarketGlobalState, type MarketOption, type MergeSharesParams, type OpenOrder, type OrderSide, type Orderbook, type OrderbookEntry, type OrderbookSide, type Position, type ProcessMatchParams, type ProcessMatchResult, type ProposeMatchParams, type ProposeMatchResult, type SplitMergeResult, type SplitSharesParams, type WalletPosition, calculateFee, calculateFeeFromTotal, calculateMatchingOrders, checkAssetOptIn, decodeGlobalState, getEscrowGlobalState, getLiveMarketsFromApi, getMarketFromApi, getMarketGlobalState, getMarketOnChain, getMarketsOnChain };