A peer-to-peer network for sharing Seaport orders.

• Overview
• Install
• Run
• API
• GraphQL

Seaport Gossip uses libp2p with the following configuration:

• Client
  • Database:
    • Prisma (ORM)
    • GraphQL (query language)
    • SQLite (DB)
  • Metrics (coming soon): Prometheus / Grafana
• Libp2p
  • Transport: websockets
  • Discovery: bootstrap
  • Content Routing: kad-dht
  • Encryption: NOISE
  • Multiplexing: mplex
  • Pub-Sub: gossipsub

To install:

git clone https://github.com/ProjectOpenSea/seaport-gossip
cd seaport-gossip
yarn

npm coming soon

Ensure you set the environment variables:

source example.env

Start a node with the GraphQL server enabled:

yarn start

Server-side bootstrap nodes are coming soon. For now, you can try testing between several nodes on your own local network. One node can be attached to the OpenSea API to ingest orders, and the others can listen to the gossiped events.

import { SeaportGossipNode, OrderEvent, OrderSort } from 'seaport-gossip'

const opts = {
  // A web3 provider allows your node to validate orders
  web3Provider: 'localhost:8550',
  // Provide the collection addresses you would like to listen to
  collectionAddresses: ["0x942bc2d3e7a589fe5bd4a5c6ef9727dfd82f5c8a"],
  // Default values:
  maxOrders: 100_000, // ~100MB (~1KB per order)
  maxOrdersPerOfferer: 100, // to mitigate order spam
}

const node = new SeaportGossipNode(opts)

const orders = await node.getOrders('0xabc', {
  sort: OrderSort.NEWEST,
  filter: { OrderFilter.BUY_NOW: true },
})
console.log(orders)

const newOrders = [{}, {}]
const numValid = await node.addOrders(newOrders)
console.log(`Valid added orders: ${numValid}`)

node.subscribe('0xabc', (event) =>
  console.log(`New event for 0xabc: ${event}`)
)

Criteria functionality is still under active development

The GraphQL server default starts at http://localhost:4000/graphql

You can query for orders, (and soon) add new orders and subscribe to events.

{
  order(
    hash: "0x38c1b56f95bf168b303e4b62d64f7f475f2ac34124e9678f0bd852f95a4ca377"
  ) {
    chainId
    offer {
      token
      identifierOrCriteria
      startAmount
      endAmount
    }
    consideration {
      token
      identifierOrCriteria
      startAmount
      endAmount
    }
  }
}

{
  orders(
    filters: [
      {
        field: offer.currentPrice
        kind: GREATER_OR_EQUAL
        value: '10000000000000000'
      }
    ]
  ) {
    hash
    offerer
  }
}

To be added to the GraphQL API, for now the API can be used via node.addOrders()

mutation AddOrders {
    addOrders(
        orders: [
            {
                ...
            }
        ]
    ) {
        accepted {
            order {
                hash
            }
            isNew
            isValid
        }
        rejected {
            hash
            code
            message
        }
    }
}

To be added to the GraphQL API, for now the API can be used via node.subscribe()

You can subscribe to order events via a subscription.

subscription {
  orderEvents {
    timestamp
    order {
      hash
      offerer
    }
  }
}

Coming soon

You can get stats for your node via the stats query.

{
  stats {
    version
    peerID
    ethChainID
    latestBlock {
      number
      hash
    }
    numPeers
    numOrders
    startOfCurrentUTCDay
    ethRPCRequestsSentInCurrentUTCDay
    ethRPCRateLimitExpiredRequests
    maxExpirationTime
  }
}