Replace Serum documentation with OpenBook

code/openbook/fill-and-fund/fill-and-fund.en.ts

@@ -0,0 +1,33 @@
+import { Account, Connection, PublicKey } from '@solana/web3.js';
+import { Market } from '@openbook-dex/openbook';
+
+let connection = new Connection('https://testnet.solana.com');
+let marketAddress = new PublicKey('...');
+let programAddress = new PublicKey('...');
+let market = await Market.load(connection, marketAddress, {}, programAddress);
+let owner = new Account('...');
+
+// Retrieving fills
+for (let fill of await market.loadFills(connection)) {
+    console.log(fill.orderId, fill.price, fill.size, fill.side);
+  }
+
+  // Settle funds
+  for (let openOrders of await market.findOpenOrdersAccountsForOwner(
+    connection,
+    owner.publicKey,
+  )) {
+    if (openOrders.baseTokenFree > 0 || openOrders.quoteTokenFree > 0) {
+      // spl-token accounts to which to send the proceeds from trades
+      let baseTokenAccount = new PublicKey('...');
+      let quoteTokenAccount = new PublicKey('...');
+
+      await market.settleFunds(
+        connection,
+        owner,
+        openOrders,
+        baseTokenAccount,
+        quoteTokenAccount,
+      );
+    }
+  }

code/openbook/fill-and-fund/fill-and-fund.preview.en.ts

@@ -0,0 +1,24 @@
+// Retrieving fills
+for (let fill of await market.loadFills(connection)) {
+    console.log(fill.orderId, fill.price, fill.size, fill.side);
+  }
+
+  // Settle funds
+  for (let openOrders of await market.findOpenOrdersAccountsForOwner(
+    connection,
+    owner.publicKey,
+  )) {
+    if (openOrders.baseTokenFree > 0 || openOrders.quoteTokenFree > 0) {
+      // spl-token accounts to which to send the proceeds from trades
+      let baseTokenAccount = new PublicKey('...');
+      let quoteTokenAccount = new PublicKey('...');
+
+      await market.settleFunds(
+        connection,
+        owner,
+        openOrders,
+        baseTokenAccount,
+        quoteTokenAccount,
+      );
+    }
+  }

code/openbook/initial-setup/initial-setup.en.ts

@@ -0,0 +1,8 @@
+import { Connection, PublicKey } from '@solana/web3.js';
+import { Market } from '@openbook-dex/openbook';
+
+let connection = new Connection('https://testnet.solana.com');
+let marketAddress = new PublicKey('...');
+let programAddress = new PublicKey('...');
+let market = await Market.load(connection, marketAddress, {}, programAddress);
+

code/openbook/initial-setup/initial-setup.preview.en.ts

@@ -0,0 +1 @@
+let market = await Market.load(connection, marketAddress, {}, programAddress);

code/openbook/order-book-interaction/order-book-interaction.en.ts

@@ -0,0 +1,27 @@
+import { Connection, PublicKey } from '@solana/web3.js';
+import { Market } from '@openbook-dex/openbook';
+
+let connection = new Connection('https://testnet.solana.com');
+let marketAddress = new PublicKey('...');
+let programAddress = new PublicKey('...');
+let market = await Market.load(connection, marketAddress, {}, programAddress);
+
+// Fetching orderbooks
+let bids = await market.loadBids(connection);
+let asks = await market.loadAsks(connection);
+
+// L2 orderbook data
+for (let [price, size] of bids.getL2(20)) {
+  console.log(price, size);
+}
+
+// Full orderbook data
+for (let order of asks) {
+  console.log(
+    order.orderId,
+    order.price,
+    order.size,
+    order.side, // 'buy' or 'sell'
+  );
+}
+

code/openbook/order-book-interaction/order-book-interaction.preview.en.ts

@@ -0,0 +1,2 @@
+let bids = await market.loadBids(connection);
+let asks = await market.loadAsks(connection);

code/openbook/order-management/order-management.en.ts

@@ -0,0 +1,27 @@
+import { Account, Connection, PublicKey } from '@solana/web3.js';
+import { Market } from '@openbook-dex/openbook';
+
+let connection = new Connection('https://testnet.solana.com');
+let marketAddress = new PublicKey('...');
+let programAddress = new PublicKey('...');
+let market = await Market.load(connection, marketAddress, {}, programAddress);
+
+// Placing orders
+let owner = new Account('...');
+let payer = new PublicKey('...'); // spl-token account
+await market.placeOrder(connection, {
+  owner,
+  payer,
+  side: 'buy', // 'buy' or 'sell'
+  price: 123.45,
+  size: 17.0,
+  orderType: 'limit', // 'limit', 'ioc', 'postOnly'
+});
+
+// Retrieving open orders by owner
+let myOrders = await market.loadOrdersForOwner(connection, owner.publicKey);
+
+// Cancelling orders
+for (let order of myOrders) {
+  await market.cancelOrder(connection, owner, order);
+}

code/openbook/order-management/order-management.preview.en.ts

@@ -0,0 +1,7 @@
+// Retrieving open orders by owner
+let myOrders = await market.loadOrdersForOwner(connection, owner.publicKey);
+
+// Cancelling orders
+for (let order of myOrders) {
+  await market.cancelOrder(connection, owner, order);
+}

docs/.vuepress/config.ts

@@ -109,7 +109,7 @@ export default defineUserConfig<DefaultThemeOptions>({
               text: "Integrations",
               children: [
                 "/integrations",
-                "/integrations/serum.md",
+                "/integrations/openbook.md",
                 "/integrations/pyth.md",
                 "/integrations/switchboard.md",
                 "/integrations/mango.md",

docs/integrations/openbook.md

@@ -0,0 +1,133 @@
+---
+title: Openbook
+head:
+  - - meta
+    - name: title
+      content: Solana Cookbook | Building on Openbook
+  - - meta
+    - name: og:title
+      content: Solana Cookbook | Building on Openbook
+  - - meta
+    - name: description
+      content: Openbook is an innovative CLOB on Solana. Learn how to use and build on top of Openbook.
+  - - meta
+    - name: og:description
+      content: Openbook is an innovative CLOB on Solana. Learn how to use and build on top of Openbook.
+  - - meta
+    - name: og:image
+      content: https://solanacookbook.com/cookbook-sharing-card.png
+  - - meta
+    - name: og:image:alt
+      content: Solana splash card
+  - - meta
+    - name: twitter:card
+      content: summary
+  - - meta
+    - name: twitter:site
+      content: "@solanacookbook"
+  - - meta
+    - name: twitter:image
+      content: "https://solanacookbook.com/cookbook-sharing-card.png"
+  - - meta
+    - name: robots
+      content: index,follow,noodp
+  - - meta
+    - name: googlebot
+      content: index,follow
+---
+
+# OpenBook
+
+OpenBook is a community-led fork of the Serum V3 program. OpenBook supports most Solana wallets including web based wallets, app wallets and hardware wallets.
+
+## Initial setup
+
+This section establishes the connection to Solana's testnet, loads the market smart contract, and defines relevant addresses.
+
+<SolanaCodeGroup>
+  <SolanaCodeGroupItem title="TS" active>
+
+  <template v-slot:default>
+
+@[code](@/code/openbook/initial-setup/initial-setup.en.ts)
+
+  </template>
+
+  <template v-slot:preview>
+
+@[code](@/code/openbook/initial-setup/initial-setup.preview.en.ts)
+
+  </template>
+
+  </SolanaCodeGroupItem>
+
+</SolanaCodeGroup>
+
+## Order Management
+
+This section illustrates how to retrieve, place, and cancel orders within the market, as well as retrieve open orders by owner.
+
+<SolanaCodeGroup>
+  <SolanaCodeGroupItem title="TS" active>
+
+  <template v-slot:default>
+
+@[code](@/code/openbook/order-management/order-management.en.ts)
+
+  </template>
+
+  <template v-slot:preview>
+
+@[code](@/code/openbook/order-management/order-management.preview.en.ts)
+
+  </template>
+
+  </SolanaCodeGroupItem>
+
+</SolanaCodeGroup>
+
+## Order Book Interaction
+
+This part of the code demonstrates interaction with the order book, including fetching L2 order book data and displaying detailed information about the full order book.
+
+<SolanaCodeGroup>
+  <SolanaCodeGroupItem title="TS" active>
+
+  <template v-slot:default>
+
+@[code](@/code/openbook/order-book-interaction/order-book-interaction.en.ts)
+
+  </template>
+
+  <template v-slot:preview>
+
+@[code](@/code/openbook/order-book-interaction/order-book-interaction.preview.en.ts)
+
+  </template>
+
+  </SolanaCodeGroupItem>
+
+</SolanaCodeGroup>
+
+## Fill Retrieval and Fund Settlement
+
+This section covers retrieving fills and settling funds after trading operations, transferring funds to specified token accounts.
+
+<SolanaCodeGroup>
+  <SolanaCodeGroupItem title="TS" active>
+
+  <template v-slot:default>
+
+@[code](@/code/openbook/fill-and-fund/fill-and-fund.en.ts)
+
+  </template>
+
+  <template v-slot:preview>
+
+@[code](@/code/openbook/fill-and-fund/fill-and-fund.preview.en.ts)
+
+  </template>
+
+  </SolanaCodeGroupItem>
+
+</SolanaCodeGroup>