@cowprotocol/cow-sdk 0.0.6 → 0.0.10

package/README.md

@@ -1,13 +1,14 @@
 <p align="center">
-  <img width="400" src="https://raw.githubusercontent.com/gnosis/cow-sdk/main/docs/images/CoW.png">
+  <img width="400" src="https://raw.githubusercontent.com/cowprotocol/cow-sdk/main/docs/images/CoW.png">
 </p>
 
 # CoW protocol SDK
-[![Styled With Prettier](https://img.shields.io/badge/code_style-prettier-ff69b4.svg)](https://prettier.io/)
 
+[![Styled With Prettier](https://img.shields.io/badge/code_style-prettier-ff69b4.svg)](https://prettier.io/)
+[![Coverage Status](https://coveralls.io/repos/github/cowprotocol/cow-sdk/badge.svg?branch=main)](https://coveralls.io/github/cowprotocol/cow-sdk?branch=main)
 
 > ⚠️⚠️ THE SDK IS IN Beta ⚠️⚠️
-> It is being currently develop and is a work in progress, also it's API is subjected to change. 
+> It is being currently develop and is a work in progress, also it's API is subjected to change.
 > If you experience any problems, please open an issue in Github trying to describe your problem.
 
 ### Getting started
@@ -34,17 +35,18 @@ The SDK will expose the CoW API operations (`cowSdk.cowApi`) and some convenient
 const trades = await cowSdk.cowApi.getOrders({
   owner: '0x00000000005ef87f8ca7014309ece7260bbcdaeb', // Trader
   limit: 5,
-  offset: 0
+  offset: 0,
 })
 console.log(trades)
 ```
 
 Let's see a full example on how to submit an order to CowSwap.
 
-> ⚠️ Before starting, the protocol requires you to approve the sell token before the order can be considered. 
+> ⚠️ Before starting, the protocol requires you to approve the sell token before the order can be considered.
 > For more details see https://docs.cow.fi/tutorials/how-to-submit-orders-via-the-api/1.-set-allowance-for-the-sell-token
 
 In this example, we will:
+
 - 1. **Instantiate the SDK and a wallet**: Used for signing orders
 - 2. **Get a price/fee quote from the API**: Get current market price and required protocol fee to settle your trade.
 - 3. **Sign the order using your wallet**: Only signed orders are considered by the protocol.
@@ -64,7 +66,7 @@ const cowSdk = new CowSdk(4, { signer: wallet })
 const quoteResponse = await cowSdk.cowApi.getQuote({
   kind: OrderKind.SELL, // Sell order (could also be BUY)
   sellToken: '0xc778417e063141139fce010982780140aa0cd5ab', // WETH
-  buyToken: '0x4dbcdf9b62e891a7cec5a2568c3f4faf9e8abe2b',  // USDC
+  buyToken: '0x4dbcdf9b62e891a7cec5a2568c3f4faf9e8abe2b', // USDC
   amount: '1000000000000000000', // 1 WETH
   userAddress: '0x1811be0994930fe9480eaede25165608b093ad7a', // Trader
   validTo: 2524608000,
@@ -96,6 +98,117 @@ const orderId = await cowSdk.cowApi.sendOrder({
 console.log(`https://explorer.cow.fi/rinkeby/orders/${orderId}`)
 ```
 
+SDK also includes a Metadata API to interact with AppData documents and IPFS CIDs
+
+```js
+const chainId = 4 // Rinkeby
+const cowSdk = new CowSdk(chainId)
+let hash = '0xa6c81f4ca727252a05b108f1742a07430f28d474d2a3492d8f325746824d22e5'
+
+// Decode AppData document given a CID hash
+const appDataDoc = await cowSdk.metadataApi.decodeAppData(hash)
+console.log(appDataDoc)
+/* {
+      "appCode": "CowSwap",
+      "metadata": {
+          "referrer": {
+              "address": "0x1f5B740436Fc5935622e92aa3b46818906F416E9",
+              "version": "0.1.0"
+          }
+      },
+      "version": "0.1.0"
+  } */
+
+const cid = 'QmUf2TrpSANVXdgcYfAAACe6kg551cY3rAemB7xfEMjYvs'
+
+// Decode CID hash to AppData Hex
+const decodedAppDataHex = await cowSdk.metadataApi.cidToAppDataHex(cid)
+console.log(decodedAppDataHex) //0x5ddb2c8207c10b96fac92cb934ef9ba004bc007a073c9e5b13edc422f209ed80
+
+hash = '0x5ddb2c8207c10b96fac92cb934ef9ba004bc007a073c9e5b13edc422f209ed80'
+
+// Decode AppData Hex to CID
+const decodedAppDataHex = await cowSdk.metadataApi.appDataHexToCid(hash)
+console.log(decodedAppDataHex) //QmUf2TrpSANVXdgcYfAAACe6kg551cY3rAemB7xfEMjYvs
+
+/*Create an AppData Document with empty metadata and default appCode
+  generateAppDataDoc receives as parameters: 
+    - metadata: MetadataDoc (Default: {})
+    - appCode: string (Default: 'Cowswap')
+*/
+const appDataDoc = cowSdk.metadataApi.generateAppDataDoc({})
+/* {
+      version: '0.1.0',
+      appCode: 'CowSwap',
+      metadata: {},
+    } 
+*/
+
+// Create an AppData Document with custom metadata and appCode
+const appDataDoc = cowSdk.metadataApi.generateAppDataDoc(
+  {
+    referrer: {
+      address: '0x1f5B740436Fc5935622e92aa3b46818906F416E9',
+      version: '0.1.0',
+    },
+  },
+  'CowApp'
+)
+/* {
+      version: '0.1.0',
+      appCode: 'CowApp',
+      metadata: {
+        referrer: {
+          address: '0x1f5B740436Fc5935622e92aa3b46818906F416E9',
+          version: '0.1.0',
+        },
+      },
+    } 
+*/
+
+// Upload AppDataDoc to IPFS (Pinata)
+const cowSdk = new CowSdk(4, {
+  ipfs: { pinataApiKey: 'YOUR_PINATA_API_KEY', pinataApiSecret: 'YOUR_PINATA_API_SECRET' },
+})
+
+await cowSdk.metadataApi.uploadMetadataDocToIpfs(appDataDoc)
+/* 0x5ddb2c8207c10b96fac92cb934ef9ba004bc007a073c9e5b13edc422f209ed80 */
+```
+
+#### Querying the Cow Subgraph
+
+You can query the Cow Subgraph either by running some common queries exposed by the `CowSubgraphApi` or by building your own ones:
+
+```js
+const chainId = 1 // Mainnet
+const cowSdk = new CowSdk(chainId)
+
+// Get Cow Protocol totals
+const { tokens, orders, traders, settlements, volumeUsd, volumeEth, feesUsd, feesEth } = await cowSdk.cowSubgraphApi.getTotals()
+console.log({ tokens, orders, traders, settlements, volumeUsd, volumeEth, feesUsd, feesEth })
+
+// Get last 24 hours volume in usd 
+const { hourlyTotals } = await cowSdk.cowSubgraphApi.getLastHoursVolume(24)
+console.log(hourlyTotals)
+
+// Get last week volume in usd
+const { dailyTotals } = await cowSdk.cowSubgraphApi.getLastDaysVolume(7)
+console.log(dailyTotals)
+
+// Get the last 5 batches
+const query = `
+  query LastBatches($n: Int!) {
+    settlements(orderBy: firstTradeTimestamp, orderDirection: desc, first: $n) {
+      txHash
+      firstTradeTimestamp
+    }
+  }
+`
+const variables = { n: 5 }
+const response = await cowSdk.cowSubgraphApi.runQuery(query, variables)
+console.log(response)
+```
+
 ### Install Dependencies
 
 ```bash
@@ -116,4 +229,3 @@ yarn start
 ```bash
 yarn test
 ```
-

package/dist/CowSdk.d.ts

@@ -0,0 +1,23 @@
+import { Signer } from 'ethers';
+import { LogLevelDesc } from 'loglevel';
+import { CowApi, CowSubgraphApi, MetadataApi } from './api';
+import { SupportedChainId as ChainId } from './constants/chains';
+import { validateAppDataDocument } from './utils/appData';
+import { Context, CowContext } from './utils/context';
+import { UnsignedOrder } from './utils/sign';
+declare type Options = {
+    loglevel?: LogLevelDesc;
+};
+export declare class CowSdk<T extends ChainId> {
+    context: Context;
+    cowApi: CowApi;
+    metadataApi: MetadataApi;
+    cowSubgraphApi: CowSubgraphApi;
+    constructor(chainId: T, cowContext?: CowContext, options?: Options);
+    updateChainId: (chainId: ChainId) => void;
+    validateAppDataDocument: typeof validateAppDataDocument;
+    signOrder(order: Omit<UnsignedOrder, 'appData'>): Promise<import("./utils/sign").SigningResult>;
+    signOrderCancellation(orderId: string): Promise<import("./utils/sign").SigningResult>;
+    _checkSigner(signer?: Signer | undefined): Signer;
+}
+export default CowSdk;

package/dist/{src/src/api → api}/cow/errors/OperatorError.d.ts

@@ -1,4 +1,4 @@
-import { CowError } from '/utils/common';
+import { CowError } from '../../../utils/common';
 declare type ApiActionType = 'get' | 'create' | 'delete';
 export interface ApiErrorObject {
     errorType: ApiErrorCodes;

package/dist/{src/src/api → api}/cow/errors/QuoteError.d.ts

@@ -1,4 +1,4 @@
-import { CowError } from '/utils/common';
+import { CowError } from '../../../utils/common';
 import { ApiErrorObject } from './OperatorError';
 export interface GpQuoteErrorObject {
     errorType: GpQuoteErrorCodes;

package/dist/{src/src/api → api}/cow/index.d.ts

@@ -1,13 +1,12 @@
-import { SupportedChainId as ChainId } from '/constants/chains';
-import { OrderCreation } from '/utils/sign';
-import { FeeQuoteParams, PriceInformation, PriceQuoteParams, SimpleGetQuoteResponse } from '/utils/price';
-import { GetOrdersParams, GetTradesParams, OrderCancellationParams, OrderID, OrderMetaData, ProfileData, TradeMetaData } from '/api/cow/types';
-import { Context } from '/utils/context';
-export declare class CowApi<T extends ChainId> {
-    chainId: T;
+import { SupportedChainId as ChainId } from '../../constants/chains';
+import { OrderCreation } from '../../utils/sign';
+import { FeeQuoteParams, PriceInformation, PriceQuoteParams, SimpleGetQuoteResponse } from '../../utils/price';
+import { GetOrdersParams, GetTradesParams, OrderCancellationParams, OrderID, OrderMetaData, ProfileData, TradeMetaData } from './types';
+import { Context } from '../../utils/context';
+export declare class CowApi {
     context: Context;
     API_NAME: string;
-    constructor(chainId: T, context: Context);
+    constructor(context: Context);
     get DEFAULT_HEADERS(): {
         'Content-Type': string;
         'X-AppId': string;
@@ -17,6 +16,7 @@ export declare class CowApi<T extends ChainId> {
     getProfileData(address: string): Promise<ProfileData | null>;
     getTrades(params: GetTradesParams): Promise<TradeMetaData[]>;
     getOrders(params: GetOrdersParams): Promise<OrderMetaData[]>;
+    getTxOrders(txHash: string): Promise<OrderMetaData[]>;
     getOrder(orderId: string): Promise<OrderMetaData | null>;
     getPriceQuoteLegacy(params: PriceQuoteParams): Promise<PriceInformation | null>;
     getQuote(params: FeeQuoteParams): Promise<SimpleGetQuoteResponse>;

package/dist/{src/src/api → api}/cow/types.d.ts

@@ -1,6 +1,6 @@
 import { OrderKind } from '@gnosis.pm/gp-v2-contracts';
-import { SupportedChainId as ChainId } from '/constants/chains';
-import { OrderCancellation, SigningSchemeValue } from '/utils/sign';
+import { SupportedChainId as ChainId } from '../../constants/chains';
+import { OrderCancellation, SigningSchemeValue } from '../../utils/sign';
 /**
  * Unique identifier for the order, calculated by keccak256(orderDigest, ownerAddress, validTo),
  * where orderDigest = keccak256(orderStruct). bytes32.
@@ -71,3 +71,4 @@ export declare type ProfileData = {
     referralVolumeUsd: number;
     lastUpdated: string;
 };
+export { FeeQuoteParams, PriceQuoteParams, QuoteParams, FeeInformation, PriceInformation, SimpleGetQuoteResponse, } from '../../utils/price';