kraken-grid 1.2.13 → 1.3.0

package/.eslintrc

@@ -0,0 +1,32 @@
+{
+  "extends": [
+    "airbnb/base",
+    "plugin:react/recommended",
+    "plugin:react-hooks/recommended",
+    "prettier"
+  ],
+  "rules": {
+    "no-unused-vars": "error",
+    "no-console": "warn",
+    "no-nested-ternary": "error",
+    "arrow-body-style": ["error", "as-needed"],
+    "react/prop-types": "error",
+    "react/react-in-jsx-scope": "off",
+    "import/prefer-default-export": "off"
+  },
+  "settings": {
+    "react": {
+      "version": "detect"
+    }
+  },
+  "env": {
+    "node": true,
+    "browser": true,
+    "es2021": true  
+  },
+//  "extends": "eslint:recommended",
+  "parserOptions": {
+    "ecmaVersion": "latest",
+    "sourceType": "module"
+  }
+}

package/.vscode/launch.json

@@ -0,0 +1,47 @@
+{
+    // Use IntelliSense to learn about possible attributes.
+    // Hover to view descriptions of existing attributes.
+    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "name": "Launch via NPM",
+            "request": "launch",
+            "runtimeArgs": [
+                "test"
+            ],
+            "runtimeExecutable": "npm",
+            "skipFiles": [
+                "<node_internals>/**"
+            ],
+            "type": "node"
+        },
+        {
+            "name": "Attach by Process ID",
+            "processId": "${command:PickProcess}",
+            "request": "attach",
+            "skipFiles": [
+                "<node_internals>/**"
+            ],
+            "type": "node"
+        },
+        {
+            "name": "Attach",
+            "port": 9229,
+            "request": "attach",
+            "skipFiles": [
+                "<node_internals>/**"
+            ],
+            "type": "node"
+        },
+        {
+            "type": "node",
+            "request": "launch",
+            "name": "Launch Program",
+            "skipFiles": [
+                "<node_internals>/**"
+            ],
+            "program": "${workspaceFolder}\\init.js"
+        }
+    ]
+}

package/JestTesting/logAlot.js

@@ -0,0 +1,27 @@
+export function logAlot() {
+    function Base64Encode(r){
+        if(/([^\u0000-\u00ff])/.test(r))throw Error("String must be ASCII");
+        var t,e,n,o,h,a,i=
+            "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/=",
+            f=[],
+            c="";
+        if((a=r.length%3)>0)
+            for(;a++<3;)
+                c+="=",r+="\0";
+        for(a=0;a<r.length;a+=3)
+            e=(t=r.charCodeAt(a)<<16|r.charCodeAt(a+1)<<8|r.charCodeAt(a+2))>>18&63,
+            n=t>>12&63,
+            o=t>>6&63,
+            h=63&t,
+            f[a/3]=i.charAt(e)+i.charAt(n)+i.charAt(o)+i.charAt(h);
+        return r=(r=f.join("")).slice(0,r.length-c.length)+c
+    }
+    function rand3() { return Base64Encode(String(Math.random())).substr(0,3); }
+
+    function log1000() {
+        for(let i = 0; i < 1000; i += 1)
+            console.log(rand3());
+    }
+
+    return {log1000};
+}

package/JestTesting/testSpy.js

@@ -0,0 +1,9 @@
+import {expect, describe, test, jest} from '@jest/globals';
+import { logAlot } from './logAlot.js';
+
+test("find AB", async () => {
+    const consoleSpy = jest.spyOn(console, "log");
+    const LA = logAlot();
+    LA.log1000();
+    expect(consoleSpy).toHaveBeenCalledWith(expect.stringMatching('AB'));
+} );

package/README.md

@@ -1,60 +1,60 @@
-<!-- START doctoc generated TOC please keep comment here to allow auto update -->
-<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
+<!-- START doctoc generated TOC please keep comment here to allow auto update -->
+<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
 **Table of Contents**  *generated with [DocToc](https://github.com/thlorenz/doctoc)*
-
-- [kraken-grid BETA](#kraken-grid-beta)
-  - [Upgrading](#upgrading)
-  - [Installation](#installation)
-  - [Usage](#usage)
-    - [How the author (Dave) does it for himself and others:](#how-the-author-dave-does-it-for-himself-and-others)
-      - [Discussion of the `adjust` command.](#discussion-of-the-adjust-command)
-    - [Web UI](#web-ui)
-      - [Orders table](#orders-table)
-      - [Allocation table](#allocation-table)
-      - [Assets table](#assets-table)
-      - [Pie Charts](#pie-charts)
-    - [Changing your password](#changing-your-password)
-    - [Mistyped passwords](#mistyped-passwords)
-    - [Command Line Interface](#command-line-interface)
-    - [Trading](#trading)
-      - [addlev](#addlev)
-      - [delev](#delev)
-      - [buy](#buy)
-      - [sell](#sell)
-      - [kill](#kill)
-      - [limits](#limits)
-      - [less](#less)
-      - [more](#more)
-    - [Information Gathering](#information-gathering)
-      - [assets](#assets)
-      - [list [Search]](#list-search)
-      - [margin](#margin)
-      - [report](#report)
-      - [show](#show)
-      - [verbose](#verbose)
-      - [web](#web)
-    - [Bot Management](#bot-management)
-      - [adjust](#adjust)
-      - [allocate](#allocate)
-      - [allocation](#allocation)
-      - [asset](#asset)
-      - [auto](#auto)
-      - [manual](#manual)
-      - [balance](#balance)
-      - [quit](#quit)
-      - [risky](#risky)
-      - [refnum](#refnum)
-      - [reset](#reset)
-      - [safe](#safe)
-      - [set](#set)
-    - [Experimental features (Not Recommended and not well tested)](#experimental-features-not-recommended-and-not-well-tested)
-      - [ws - EXPERIMENTAL](#ws---experimental)
-  - [Internals](#internals)
-    - [Userref](#userref)
-    - [Partial Execution](#partial-execution)
-  - [HELP!](#help)
-
-<!-- END doctoc generated TOC please keep comment here to allow auto update -->
+
+- [kraken-grid BETA](#kraken-grid-beta)
+  - [Upgrading](#upgrading)
+  - [Installation](#installation)
+  - [Usage](#usage)
+    - [How the author (Dave) does it for himself and others:](#how-the-author-dave-does-it-for-himself-and-others)
+      - [Discussion of the `adjust` command.](#discussion-of-the-adjust-command)
+    - [Web UI](#web-ui)
+      - [Orders table](#orders-table)
+      - [Allocation table](#allocation-table)
+      - [Assets table](#assets-table)
+      - [Pie Charts](#pie-charts)
+    - [Changing your password](#changing-your-password)
+    - [Mistyped passwords](#mistyped-passwords)
+    - [Command Line Interface](#command-line-interface)
+    - [Trading](#trading)
+      - [addlev](#addlev)
+      - [delev](#delev)
+      - [buy](#buy)
+      - [sell](#sell)
+      - [kill](#kill)
+      - [limits](#limits)
+      - [less](#less)
+      - [more](#more)
+    - [Information Gathering](#information-gathering)
+      - [assets](#assets)
+      - [list [Search]](#list-search)
+      - [margin](#margin)
+      - [report](#report)
+      - [show](#show)
+      - [verbose](#verbose)
+      - [web](#web)
+    - [Bot Management](#bot-management)
+      - [adjust](#adjust)
+      - [allocate](#allocate)
+      - [allocation](#allocation)
+      - [asset](#asset)
+      - [auto](#auto)
+      - [manual](#manual)
+      - [balance](#balance)
+      - [quit](#quit)
+      - [risky](#risky)
+      - [refnum](#refnum)
+      - [reset](#reset)
+      - [safe](#safe)
+      - [set](#set)
+    - [Experimental features (Not Recommended and not well tested)](#experimental-features-not-recommended-and-not-well-tested)
+      - [ws - EXPERIMENTAL](#ws---experimental)
+  - [Internals](#internals)
+    - [Userref](#userref)
+    - [Partial Execution](#partial-execution)
+  - [HELP!](#help)
+
+<!-- END doctoc generated TOC please keep comment here to allow auto update -->
 
 # kraken-grid BETA
 A bot that extends grid trading once you use it to create a grid using orders with conditional closes.
@@ -92,7 +92,7 @@ If you have proceeded with step four of the installation, then you have a runnin
 5. If you have some other crypto on the exchange, you can do the same thing with it as I described in step 4 for XXBT (bitcoin). During a heavy drop across all cryptos, this will cause your USD allocation to drop a lot.  For this reason, the bot won't let you do an adjustment that would require a negative allocation of USD. It misreports this as "You'd run out of cash" which should be "You'd have to short USD".
 6. Once you have determined the allocation you want, with enough allocated to USD to make adjustments at lower prices, and you've added all the adjustments you want (only one for each crypto), then you can use the `balance` command. In the lower table of the web page, there is a clickable number in the upper left corner which says "Balance Tolerance" when you hover over it.  This is used to build a `balance` command that will be proposed to be sent to the bot when you click the price of any asset. We recommend reading the documentation for `balance` as it places trades for you to achieve your target allocation and maintain it when the bot is in `auto` mode.
 #### Discussion of the `adjust` command.
-This strategy can only _increase_ the allocation, and not decrease it.  To put it simply, allocation should be set to how much of your savings you want to be in this asset when it's _at the highest price_.  Let's sayyou want the allocation to be perfectly even across all assets. When the prices are (all) at the bottom, you want all your cash to be spent. Here's how to set this up, assuming you want to hold at least half of your target allocation in an asset _at its highest price_ and the full target at the lowest one (This assumes you choose a trading range of 20%):
+Using [adjust](#adjust) can only _increase_ the allocation, and not decrease it.  To put it simply, allocation should be set to how much of your savings you want to be in this asset when it's _at the highest price_.  Let's say you want the allocation to be perfectly even across all assets. When the prices are (all) at the bottom, you want all your cash to be spent. Here's how to set this up, assuming you want to hold at least half of your target allocation in an asset _at its highest price_ and the full target at the lowest one (This assumes you choose a trading range of 20%):
 
 For a single crypto: Set your allocation to 50% (and 50% in USD or EUR or YEN, your _numeraire_, meaning the currency you use). Your adjust command would be `adjust TKR 50 20` where TKR is the ticker for your crypto. For two cryptos, set the allocation for each to 33.33% (leaving 33.33% for your numeraire). Your adjust command would be `adjust TKR 16.67 20` for each one.
 
@@ -144,7 +144,7 @@ The semantics are the same as for [delev](#delev).
 
 #### delev
 `delev Counter`
-C _must be_ a `Counter` as shown by executing [list](#list).  If the identified order uses leverage, this command will first create an order without any leverage to replace it, and then kill the one identified. The order that was killed will still be in the list, prefixed with `Killed:` *NOTE: The new order often (or always?) appears at the top of `list` after this, so the `Counter`s identifying other orders may change.*
+Counter _must be_ a `Counter` as shown by executing [list](#list).  If the identified order uses leverage, this command will first create an order without any leverage to replace it, and then kill the one identified. The order that was killed will still be in the list, prefixed with `Killed:` *NOTE: The new order often (or always?) appears at the top of `list` after this, so the `Counter`s identifying other orders may change.*
 
 #### buy
 `buy Ticker Price Amount ClosePrice`
@@ -206,7 +206,7 @@ XLTC ...
 ...
 ```
 2. Retrieves the list of open orders, which is immediately processed to:
-   1.  replace conditional closes resulting from partial executions with a single conditional close which, itself, has a conditional close to continue buying and selling between the two prices, but only up to the amount originally specified, and _only_ for orders with a User Reference Number (such as all orders placed through this program).
+   1.  replace conditional closes resulting from partial executions with a single conditional close which, itself, has a conditional close to continue buying and selling between the two prices, but only up to the amount originally specified, and _only_ for orders with a User Reference Number (such as all orders placed through this program). Note: If you place a conditional close order with a price that matches one side of an existing grid point and it executes, creating the conditional close, that new order will be added in with the others, increasing the size of the trade around that grid point.
    2.  fill out the internal record of buy/sell prices using the open orders and their conditional closes (see [set](#set) and [reset](#reset)).
    3.  extend the grid if there are only buys or only sells remaining for the crypto identified in each order.
    4.  identify any orders that are gone or new using Kraken's Order ID and for new orders, it also describes them.