feature-complete interface

interface/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "@polywrap/random-interface",
+  "description": "Polywrap Random Interface",
+  "version": "0.10.0",
+  "scripts": {
+    "build": "npx polywrap build",
+    "deploy": "npx polywrap deploy -o deployment.json"
+  },
+  "devDependencies": {
+    "polywrap": "~0.10.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

interface/polywrap.deploy.yaml

@@ -0,0 +1,9 @@
+format: 0.2.0
+jobs:
+  ipfs_deploy:
+    steps:
+      - name: ipfs_deploy
+        package: ipfs
+        uri: fs/./build
+        config:
+          gatewayUri: https://ipfs.wrappers.io

interface/polywrap.graphql

@@ -0,0 +1,47 @@
+type Module {
+  """
+  Generates a random Int within the range [min, max).
+  """
+  nextInt(min: Int, max: Int): Int!
+
+  """
+  Generates a random UInt within the range [min, max).
+  """
+  nextUInt(min: UInt, max: UInt): UInt!
+
+  """
+  Generates a random Float within the range [min, max).
+  """
+  nextFloat(min: Int, max: Int): BigNumber!
+
+  """
+  Generates a random Boolean value.
+  """
+  nextBoolean: Boolean!
+
+  """
+  Generates a random byte sequence of the specified length.
+  """
+  nextBytes(length: Int!): Bytes!
+
+  """
+  Generates a random string of the specified length.
+  """
+  nextString(length: Int!): String!
+
+  """
+  Generates a list of random integers of the given length, each within the range [min, max).
+  """
+  nextInts(length: Int, min: Int, max: Int): [Int!]!
+
+  """
+  Generates an array of randomly sorted integers of the given length.
+  """
+  shuffle(length: Int): [Int!]!
+
+  """
+  Sets the seed of the random number generator for replicable results.
+  """
+  seed(seed: Int!): Boolean!
+}
+

interface/polywrap.yaml

@@ -0,0 +1,6 @@
+format: 0.3.0
+project:
+  name: random-interface
+  type: interface
+source:
+  schema: ./polywrap.graphql

interface/resources/README.md

@@ -0,0 +1,50 @@
+# Random Wrapper Interface
+
+| Version | URI                                                                                     | WRAP Version |
+|-|-----------------------------------------------------------------------------------------|-|
+| 1.0.0 | [`wrap://ens/wraps.eth:random@1.0.0`](https://wrappers.io/v/ens/wraps.eth:random@1.0.0) | 0.1 |
+
+## Interface
+```graphql
+type Module {
+    # get a random Int, bounded by [min, max)
+    nextInt(min: Int, max: Int): Int!
+
+    # get a random UInt, bounded by [min, max)
+    nextUInt(min: UInt, max: UInt): UInt!
+
+    # get a random Float, bounded by [min, max)
+    nextFloat(min: Int, max: Int): BigNumber!
+
+    # get a random Boolean
+    nextBoolean: Boolean!
+
+    # get a random byte sequence of the given length
+    nextBytes(length: Int!): Bytes!
+
+    # get a random string of the given length
+    nextString(length: Int!): String!
+
+    # get a list of random integers with the given length, bounded by [min, max)
+    nextInts(length: Int, min: Int, max: Int): [Int!]!
+
+    # an array of randomly sorted integers
+    shuffle(length: Int): [Int!]!
+
+    # set the seed of the random number generator for replicable results
+    seed(seed: Int!): Boolean!
+}
+```
+
+## Usage
+```graphql
+#import * from "ens/wraps.eth:random@1.0.0"
+```
+
+And implement the interface methods within your programming language of choice.
+
+## Source Code
+[Link](https://github.com/polywrap/std/random)
+
+## Known Implementations
+[Link](https://github.com/polywrap/random/tree/master/implementations)