examples: Swap on the serum orderbook (#224)

.gitmodules

@@ -0,0 +1,3 @@
+[submodule "examples/swap/deps/serum-dex"]
+	path = examples/swap/deps/serum-dex
+	url = https://github.com/project-serum/serum-dex

.travis.yml

@@ -6,6 +6,8 @@ cache: cargo
 env:
   global:
     - NODE_VERSION="14.7.0"
+git:
+  submodules: true
 
 _defaults: &defaults
   before_install:
@@ -65,6 +67,7 @@ jobs:
       script:
         - pushd examples/chat && yarn && anchor test && popd
         - pushd examples/ido-pool && yarn && anchor test && popd
+        - pushd examples/swap/deps/serum-dex/dex && cargo build-bpf && cd ../../../ && anchor test && popd
         - pushd examples/tutorial/basic-0 && anchor test && popd
         - pushd examples/tutorial/basic-1 && anchor test && popd
         - pushd examples/tutorial/basic-2 && anchor test && popd

Cargo.toml

@@ -8,3 +8,6 @@ members = [
     "lang/syn",
     "spl",
 ]
+exclude = [
+    "examples/swap/deps/serum-dex"
+]

examples/swap/Anchor.toml

@@ -0,0 +1,6 @@
+cluster = "localnet"
+wallet = "~/.config/solana/id.json"
+
+[[test.genesis]]
+address = "9xQeWvG816bUx9EPjHmaT23yvVM2ZWbrrpZb9PusVFin"
+program = "./deps/serum-dex/dex/target/deploy/serum_dex.so"

examples/swap/Cargo.toml

@@ -0,0 +1,7 @@
+[workspace]
+members = [
+    "programs/*"
+]
+exclude = [
+    "deps/serum-dex"
+]

examples/swap/README.md

@@ -0,0 +1,34 @@
+# Swap
+
+An example swap program that provides a convenient API to the Serum orderbook
+for performing instantly settled token swaps.
+
+## Usage
+
+This example requires building the Serum DEX from source, which is done using
+git submodules.
+
+### Install Submodules
+
+Pull the source
+
+```
+git submodule init
+git submodule update
+```
+
+### Build the DEX
+
+Build it
+
+```
+cd deps/serum-dex/dex/ && cargo build-bpf && cd ../../../
+```
+
+### Run the Test
+
+Run the test
+
+```
+anchor test
+```

examples/swap/migrations/deploy.js

@@ -0,0 +1,12 @@
+// Migrations are an early feature. Currently, they're nothing more than this
+// single deploy script that's invoked from the CLI, injecting a provider
+// configured from the workspace's Anchor.toml.
+
+const anchor = require("@project-serum/anchor");
+
+module.exports = async function (provider) {
+  // Configure client to use the provider.
+  anchor.setProvider(provider);
+
+  // Add your deploy script here.
+}

examples/swap/programs/swap/Cargo.toml

@@ -0,0 +1,19 @@
+[package]
+name = "swap"
+version = "0.1.0"
+description = "Created with Anchor"
+edition = "2018"
+
+[lib]
+crate-type = ["cdylib", "lib"]
+name = "swap"
+
+[features]
+no-entrypoint = []
+no-idl = []
+cpi = ["no-entrypoint"]
+default = []
+
+[dependencies]
+anchor-lang = { path = "../../../../lang" }
+anchor-spl = { path = "../../../../spl" }

examples/swap/programs/swap/Xargo.toml

@@ -0,0 +1,2 @@
+[target.bpfel-unknown-unknown.dependencies.std]
+features = []