<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0" xmlns:cc="http://cyber.law.harvard.edu/rss/creativeCommonsRssModule.html">
    <channel>
        <title><![CDATA[Stories by Riley James on Medium]]></title>
        <description><![CDATA[Stories by Riley James on Medium]]></description>
        <link>https://medium.com/@riley-james?source=rss-a2a16bfb4383------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/1*vyXeJqDvVkkUK5GhvXUQeg.jpeg</url>
            <title>Stories by Riley James on Medium</title>
            <link>https://medium.com/@riley-james?source=rss-a2a16bfb4383------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Wed, 18 Nov 2026 03:04:46 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@riley-james/feed" rel="self" type="application/rss+xml"/>
        <webMaster><![CDATA[yourfriends@medium.com]]></webMaster>
        <atom:link href="http://medium.superfeedr.com/" rel="hub"/>
        <item>
            <title><![CDATA[Four ways to experience the XeroAPI without writing any code]]></title>
            <link>https://riley-james.medium.com/four-ways-to-experience-the-xeroapi-without-writing-any-code-b9e82ce708cf?source=rss-a2a16bfb4383------2</link>
            <guid isPermaLink="false">https://medium.com/p/b9e82ce708cf</guid>
            <category><![CDATA[insomnia]]></category>
            <category><![CDATA[no-code]]></category>
            <category><![CDATA[xeroapi]]></category>
            <category><![CDATA[xero-integration]]></category>
            <dc:creator><![CDATA[Riley James]]></dc:creator>
            <pubDate>Wed, 11 Aug 2021 02:51:04 GMT</pubDate>
            <atom:updated>2021-08-11T02:51:04.835Z</atom:updated>
            <content:encoded><![CDATA[<p>Sometimes there’s a gap between reading the docs and writing your integration. The gap between confirming a use case, verifying the api works as you expect (based on your reading of the docs) and actually writing some code to prove your assumptions correct. You don’t want to (or maybe you can’t) go all the way to downloading &amp; running one the Xero SDKs.</p><p>While this may sound strange to a gun slinging, bare metal, “I don’t always push to production, but..” kind of dev, yet at larger enterprises many non-dev’s won’t have all the access required (or permission) to setup dev accounts of this nature. Beyond that, those responsible for scoping the business case for partnership or feasibility of an integration are unlikely to later pick the tools and build it themselves. So the more empowered a non-technical user is to verify what the api does and how it works, the more likely their work will represent reality and enable a dev to turn their vision into reality.</p><p>So let’s look at the options!</p><h3>Xero API Explorer</h3><p>The <a href="https://api-explorer.xero.com/">Xero API explorer</a> is an awesome way to get started with the API directly in your browser, all you’ll need is a free xero developer account (self sign up via: <a href="https://developer.xero.com/">developer.xero.com</a>)</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1004/1*Ag_1b-B4OwAjk5lrRfRj4w.png" /><figcaption>Xero API Explorer</figcaption></figure><p>Xero API explorer is a full http client in the browser, built by the Xero dev team specifically for Xero’s API. You can make API requests to all the Xero Product API’s: Accounting, Payroll, Files, Assets &amp; Projects.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/988/1*TYVhx-t8wmVJevXh6qNT7Q.png" /><figcaption>Xero API Explorer Request</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/992/1*zQYHdvwakx9ybf4NdJCQYQ.png" /><figcaption>Xero API Explorer Responses</figcaption></figure><h3>Insomnia</h3><p>Understand HTTP clients, but want to get out of the browser, you’ve got options. Insomnia is the slimmer, open source alternative to postman. My personal preference of the gui http client options (postman has become overkill for shooting off a couple of api requests).</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*kEqBBnWaP6AmNeDOTWHRkw.png" /></figure><p>Developer Evangelist Chris Knight has written a great guide on using <a href="https://devblog.xero.com/insomnia-client-xeroapi-auth-1c4cf485f251">Insomnia with the Xero API</a>. It’s made super simple with the Insomnia collection that’s been written by the Xero team.</p><p><a href="https://insomnia.rest/download">Download insomnia</a>, clone (or download) the <a href="https://github.com/XeroAPI/Xero-Insomnia">insomnia collection repo</a>, import and you’re good to go. Check Chris’s guide for a step by step walkthrough of the whole process.</p><p>Prefer a youtube tutorial walkthrough, Chris has you covered there too: <a href="https://www.youtube.com/watch?v=H_k8Z8Zq99s">https://www.youtube.com/watch?v=H_k8Z8Zq99s</a></p><h3>Postman</h3><p>The most popular http client, that now has every tool in the API toolshed available within it. A little overkill for sending a few http requests to the api. Tho if you’re looking to mock an integration and test if your end to end use cases are going to be supported, Postman has all the tools you’d need.</p><p>To help you along your journey, the Xero API team have put together a Postman collection: <a href="https://github.com/XeroAPI/xero-postman-oauth2">https://github.com/XeroAPI/xero-postman-oauth2</a></p><p>The read me has all the details you’ll need to get started, but if you’d prefer to see how it’s done step by step, there’s a <a href="https://www.youtube.com/watch?v=iIYI_JIUHfk">video walkthrough</a> available.</p><h3>Sample Apps</h3><p>Sample apps are fully fledged applications built using Xero’s own SDKs. While they don’t require you to write any code, you will need to be comfortable and familiar with the underlying programming language in order to install &amp; use them.</p><p>That said, it’s a great way to experience the API as it’s as close as you’ll get to experiencing what building an integration with the Xero API will look like without writing a single line of code.</p><p>In addition, if you are comfortable wrangling a few lines of code, you could get an example use case for your integration running extremely quickly by forking a sample project and customising it for your needs.</p><h4>PHP</h4><ul><li><a href="https://github.com/XeroAPI/xero-php-oauth2">SDK</a> &amp; <a href="https://github.com/XeroAPI/xero-php-oauth2#sample-applications">Sample Apps</a></li></ul><h4>.Net</h4><ul><li><a href="https://github.com/XeroAPI/Xero-NetStandard">SDK</a> &amp; <a href="https://github.com/XeroAPI/Xero-NetStandard#sample-applications">Sample Apps</a></li></ul><h4>Java</h4><ul><li><a href="https://github.com/XeroAPI/Xero-Java">SDK</a> &amp; <a href="https://github.com/XeroAPI/Xero-Java#sample-applications">Sample Apps</a></li></ul><h4>Node</h4><ul><li><a href="https://github.com/XeroAPI/xero-node">SDK</a> &amp; <a href="https://github.com/XeroAPI/xero-node#sample-applications">Sample Apps</a></li></ul><h4>Ruby</h4><ul><li><a href="https://github.com/XeroAPI/xero-ruby">SDK</a> &amp; <a href="https://github.com/XeroAPI/xero-ruby#sample-applications">Sample Apps</a></li></ul><h4>Python</h4><ul><li><a href="https://github.com/XeroAPI/xero-python">SDK</a> &amp; <a href="https://github.com/XeroAPI/xero-python#sample-applications">Sample Apps</a></li></ul><p>Some languages have multiple sample apps available, for most integrations you’re going to looking for the starter or full app, both of which are built for OAuth 2. You may also want look at <a href="https://developer.xero.com/documentation/guides/oauth2/custom-connections/">Custom Connections</a>, if you’re building an internal integration for your own business.</p><p>If you setup the full app (OAuth 2) you’ll be presented with something similar to this:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*xpeVnR4uPi8VlnXTXBFa1w.png" /><figcaption>Xero Sample App Full App for Ruby (rails)</figcaption></figure><p>They contain all the authentication features, multiple orgs, refresh, change orgs. And then each endpoint is setup to make requests back and forth.</p><p>So to customise it for your own use case, just start setting up some additional endpoints to cover your needs. You’ll be impressed how far you can get with a little copy and paste!</p><p>Enjoy!</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=b9e82ce708cf" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Sequelize, Postgres, JSON & JSONB]]></title>
            <link>https://medium.com/codex/sequelize-postgres-json-jsonb-c1d4a80a0a51?source=rss-a2a16bfb4383------2</link>
            <guid isPermaLink="false">https://medium.com/p/c1d4a80a0a51</guid>
            <category><![CDATA[rails]]></category>
            <category><![CDATA[sequelize]]></category>
            <category><![CDATA[postgres]]></category>
            <category><![CDATA[jsonb]]></category>
            <dc:creator><![CDATA[Riley James]]></dc:creator>
            <pubDate>Wed, 04 Aug 2021 06:25:30 GMT</pubDate>
            <atom:updated>2021-08-25T00:55:04.810Z</atom:updated>
            <content:encoded><![CDATA[<p>Here’s a few gotchas I’ve run into while working with sequelize. Writing them down to hopefully save someone else a few minutes.</p><p>Sequelize is a pretty awesome ORM for node, it’s giving me strong active record vibes and I like it!</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/774/1*BWLEHbhCCRqg-XY2ocYcwg.png" /></figure><p>It features</p><ul><li>seeds &amp; migrations.</li><li>Eager &amp; lazy loading of associated models.</li><li>Hooks (lifecycle methods / callbacks)</li><li>Generators (npx sequelize-cli)</li></ul><h4>Sync your models</h4><p>One feature which sequelize has over active record is the capability to ‘sync’ your models to the db. Effectively it generates a schema &amp; applies it to the db (tho it’d be cool if a schema file was generated as well, maybe I haven’t found that yet).</p><p>Why’s that interesting? Well in the rails world you’d generate models &amp; migrations and migrate the database as you go. And that’s the right way to do it, in production. But with a new projects where you’re iterating quickly on the basics, it’s a little overkill. Once you get to a v1 or earlier, you’ll want to start using migrations. But while your project only exists on localhost, it’s nice to have one spot to make changes (models) and have the changes propagate through.</p><p>And that’s what sync does.</p><p>Docs: <a href="https://sequelize.org/master/manual/model-basics.html#model-synchronization">https://sequelize.org/master/manual/model-basics.html#model-synchronization</a></p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/2816d71d90c49287a6abdc6bdb2bedc3/href">https://medium.com/media/2816d71d90c49287a6abdc6bdb2bedc3/href</a></iframe><p>There are options to force, alter or only create missing tables. So far I’ve used force, but gated the feature behind an env variable so that it doesn’t wipe the database on every code change (using nodemon for reloading).</p><p>Wouldn’t put this anywhere near my production code, but in early stage dev I love it. It makes the imagination to models process that little bit more instantaneous.</p><h4>Possible Improvements:</h4><p>While sync is great in dev, it would be awesome if there was a clearer path to switching from sync to migrations. As mentioned earlier, if sync could generate a schema (or just migrations directly) at a point in time (when you’re transitioning to production, versioning or bringing on more devs) that would make for a great workflow.</p><p>Presently it feels like one of the other proposition when it comes to migrations &amp; sync, and there will inevitably be a transition point between them. Using generators to generate models (which generate a corresponding migration) immediately fall out of ‘sync’ when you change the model, and sync it. Where as I’d like to generate my models, work on them, and then generate migrations from the those models at a later stage.</p><p>Seeds feel similarly disconnected, in that the generated seed syntax utilises SQL queries to create &amp; drop seed data, where as I’d prefer to use my models to do so, during the initial dev and then generate seeds / fixtures at a later stage. Definitely depends on the volume of data, and personal preferences, so mileage will vary there.</p><p>Someone has probably solved these already and I’ve just not found it yet, if you have a better way ping me on twitter.</p><h3>Postgres JSON vs JSONB</h3><p>But while sync is cool, JSON vs JSONB was downright annoying until I worked out what I was doing wrong.</p><p><strong>Take note:</strong> When using sequelize, postgres &amp; DataTypes.JSON your data is <em>actually</em> stored as plaintext, not json.</p><p>This leads to all sorts of annoying parsing &amp; stringifying json in and out of the db.</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/7e6e81a6ae1d5d17b85a471c7b570be6/href">https://medium.com/media/7e6e81a6ae1d5d17b85a471c7b570be6/href</a></iframe><p>Before I realised what was actually going on, thinking ‘why the hell did they decide this was a good idea?’, I’d setup get() &amp; set() methods to parse &amp; stringify the json.</p><p>I hadn’t chosen JSONB because I didn’t think I’d need to query these fields directly, so it seemed overkill. And I figured I could switch it at any stage later pretty quickly.</p><p>Upon consulting the docs again, I see:</p><h3>Note for PostgreSQL</h3><p>The JSON data type in PostgreSQL stores the value as plain text, as opposed to binary representation. If you simply want to store and retrieve a JSON representation, using JSON will take less disk space and less time to build from its input representation. However, if you want to do any operations on the JSON value, you should prefer the JSONB data type described below.</p><p>Docs: <a href="https://sequelize.org/master/manual/other-data-types.html">https://sequelize.org/master/manual/other-data-types.html</a></p><p><strong>Also note: JSONB is only available with Postgres</strong></p><p>So, it sounds like there are some performance benefits for using JSON, if you don’t need to query the data within the JSON directly. But if you choose to use JSON, you’ll need to manage serialising the data in &amp; our of the database (which is only a few lines of code).</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=c1d4a80a0a51" width="1" height="1" alt=""><hr><p><a href="https://medium.com/codex/sequelize-postgres-json-jsonb-c1d4a80a0a51">Sequelize, Postgres, JSON &amp; JSONB</a> was originally published in <a href="https://medium.com/codex">CodeX</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Introducing Search Share]]></title>
            <link>https://riley-james.medium.com/introducing-search-share-1d8ba9dec51c?source=rss-a2a16bfb4383------2</link>
            <guid isPermaLink="false">https://medium.com/p/1d8ba9dec51c</guid>
            <category><![CDATA[brave-browser]]></category>
            <category><![CDATA[decentralised]]></category>
            <category><![CDATA[notary]]></category>
            <category><![CDATA[tls]]></category>
            <category><![CDATA[web-scraping]]></category>
            <dc:creator><![CDATA[Riley James]]></dc:creator>
            <pubDate>Mon, 19 Jul 2021 02:16:47 GMT</pubDate>
            <atom:updated>2021-07-19T02:16:47.747Z</atom:updated>
            <content:encoded><![CDATA[<h4>A proof of concept for verifiable, decentralised, web scraping (data collection)</h4><p>SearchShare is a PoC for sharing verified search engine results between users.<br><br>It enables a user to submit a copy of the search result they&#39;ve received from a search engine, in a manner which does not enable the user to tamper or manipulate the results received. In doing so, it enables at trustless relationship between users.<br><br>Once search results have been submitted, users visit the website to compare results between users, between queries &amp; between search engines.<br><br>The use case builds upon the concepts of notarisation which enables the creation of signed copies of web pages, which are provably authentic &amp; independently verifiable. Signed pages can not be modified, manipulated or tampered with by the user who created them, or any parties who received them. The signed page is authenticate in that it is represents the web page (web resource, or dom) as requested by the user, and delivered by the server.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*EOlpBUGZm8z4RbNx.png" /></figure><h3>Important Links</h3><ul><li>SearchShare: <a href="https://searchshare.proofs.sh/">https://searchshare.proofs.sh</a></li><li>SearchShare Extension: <a href="https://github.com/rjaus/search-share-extension">https://github.com/rjaus/search-share-extension</a></li></ul><h3>TLDR</h3><h3>Problem</h3><p>Lets say one day you ponder the question:</p><blockquote><em>How are the search results I receive different to those that my friends receive?</em></blockquote><p>How would you solve this problem?</p><p>Screenshots is an obvious solution, but lets add a complication, you don’t trust your friends to provide accurate results.</p><p>Either through malicious intent, or technical incompetence, you can not rely on your friends to provide accurate results. Technical incompetence could include an inability to take a screenshots, taking screenshots which miss vital details, full length screenshots vs visible area of browser, screenshots which include sensitive details outside the browser window.</p><p>Some problems with screenshots:</p><ul><li>Not easily machine readable (requires OCR or machine learning to extract data)</li><li>Do not verify any details of the data source</li><li>Can be manipulated after they’ve been taken</li><li>Websites can be manipulated prior to screenshots being taken</li></ul><h3>Solution</h3><p>Search Share solves this problem by having users submit signed (notarised) copies of their search results, which can then be parsed and compared.</p><p>Example: <a href="https://searchshare.proofs.sh/compare/6/8">https://searchshare.proofs.sh/compare/6/8</a></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*FVBEzOuiM4G0taFG.png" /></figure><p>/TLDR</p><h3>Getting started</h3><p>To explore search results that have been submitted by users, simply visit the website: <a href="https://searchshare.proofs.sh/compare/6/8">https://searchshare.proofs.sh/compare/6/8</a></p><p>The process for submitting your own search results requires a few setup steps, see this doc: <a href="https://github.com/rjaus/search-share-docs/blob/master/How-to-submit.md">How to submit search results</a></p><h3>How does it work?</h3><p>The PoC utilises <a href="https://tlsnotary.org/">TLS Notary</a> as the mechanism for signing (notarising) web pages. Signed web pages are then submitted to a centralised service, which parses &amp; presents the ranking data to users.</p><p>The PoC works with:</p><ul><li>Duckduckgo</li><li>Google</li><li>Brave Search</li><li>Bing</li></ul><p>From the users perspective, the process of signing &amp; submitting search results consists of:</p><ol><li>Install the ‘Search Share’ chrome extension.</li><li>Visit a search engine and submit a query (eg: <a href="https://duckduckgo.com/?q=hacker+news">https://duckduckgo.com/?q=hacker+news</a>)</li><li>Use the chrome extension to generate a signed/notarised copy of the page</li><li>Submit (share) the signed copy of the web page to the SearchShare API/website so that other users can see their search results</li></ol><p>On the server side, the signed page is verified against the notary, to ensure it has not been tampered with. The signed copy is then converted to plaintext, and the search engine rankings are parsed from the plaintext.</p><p>A visitor to SearchShare has access only to the parsed search engine rankings, they can not access the plaintext nor the signed page.</p><p>Using this architecture, the visitor can is assured that the search engine rankings presented are accurate, as delivered by the source (search engine). They can be assured that the user who submitted them has not modified or manipulated the results.</p><p>As a centralised service, the visitor does need to trust that the centralised service (Search Share) has not modified the rankings / results, and they have competently verified the authenticity of the signed pages submitted by the user.</p><p>The decision for a centralised vs decentralised architecture for this PoC was made primarily with the intent of releasing the PoC quickly and continue iterating. See later section for discussion for further explanation.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=1d8ba9dec51c" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Free Airpods for developers]]></title>
            <link>https://riley-james.medium.com/free-airpods-for-developers-be6bc7fb81ef?source=rss-a2a16bfb4383------2</link>
            <guid isPermaLink="false">https://medium.com/p/be6bc7fb81ef</guid>
            <category><![CDATA[free-airpods]]></category>
            <category><![CDATA[openbase]]></category>
            <category><![CDATA[developer-competition]]></category>
            <dc:creator><![CDATA[Riley James]]></dc:creator>
            <pubDate>Mon, 28 Jun 2021 01:10:41 GMT</pubDate>
            <atom:updated>2021-06-28T01:10:41.937Z</atom:updated>
            <content:encoded><![CDATA[<p>A few months ago my partner started a masters in counselling. In doing so, it was time for an upgrade from the 2010 Macbook air I’d handed down to her years earlier (still going strong despite the dead battery, which I know is easily replaceable, but the first I ordered was DOA and I never got around to a second attempt)</p><p>So she ordered an iPad, with a pen (as yet unused) and Apple threw in a free pair of Airpods, part of the ‘back to uni’ specials they run (on top of standard discount for students, 15%??).</p><p>I’ve been resistant to Air Pods, I justified it with:</p><p>- the batteries can’t be replace, it’s just e-junk*<br>- I love my iphone, but I will not buy into the cult of apple (no macbook, no appletv, no icloud, no macOS, etc, etc)<br>- who want another devise that can go flat? Another battery to keep charged<br>- Sounds quality issues over bluetooth*<br>- Nothing wrong with the free corded headphones (tho you had to require a FFFFF dongle FFS, or switch to corded headphones which work on NOTHING ELSE)</p><p>*Not sure the validity of these claims, only read the headlines. Again, it was mostly about having some excuses not to buy them.</p><p>The only draw card I saw, with Airpods I could charge while using them. But when I consider that this was a design flaw that Apple themselves implemented I was resistant to hand over more money to solve their short comings in product design.</p><p>My partner loved hers, immediately. I was resistant even to try them, in fear I might like them. So months passed, and I forgot all about Airpods.</p><p>And then one day, my phone was low on battery, and I had an important meeting that I had to join via my phone. I had 30 seconds to solve it, thought of her Airpods, and borrowed them.</p><p>Within 10 seconds of opening the Airpods, they were connected &amp; working. Wow! That was easy. Best technology experience I’ve had in a very very long time.</p><p>I was instantly sold, I wanted Airpods! but that just created a new problem. My partner got these for free!! They are worth nothing to Apple, and I’m already sick of giving them $$$$ for overpriced hardware.</p><p>I resigned to maintain using the standard corded phones, but now I felt their inferiority every time I used them.</p><p>And then a week later, I stumbled upon <a href="https://openbase.com/">OpenBase</a>. I can’t recall exactly how, no doubt I was googling (with DDG, naturally) for some documentation, or a library (working on the mvp/prototype for <a href="https://search-share.herokuapp.com/">SearchShare</a>).</p><p>I was impressed, it’s far from a new idea, it’s been done, but badly. OpenBase immediately seemed useful, rather than spamy. It clearly laid out a bunch of metrics, documentation, reviews, license. All details I use to determine if this package is a good choice for my project. Usually this involves NPM/Yarn =&gt; Github or RubyToolbox =&gt; Github (via the mostly useless intermediary that is RubyGems).</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/215/1*NhxtFxktbuEnIxs-xUGrTQ.png" /></figure><p>But what is this golden cup countdown in the top right hand corner, intrigued, I clicked.</p><p>A competition? And the prize is AIRPODS!!!!!!! This is it, my chance. To get what I desire, how I desire!!</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/835/1*W1A-1_AS_vm0t4Fz8CENWA.png" /><figcaption>Too good to be true? Always read the T&amp;Cs.</figcaption></figure><p>I scanned the terms and conditions, yes, they will ship to NZ, terms seem pretty standard. And then I googled the name and found they were backed by YC, so that seemed legit enough to me.</p><p>There was 1d 16h on the clock, and someone was already on top of the leaderboard with 12 or so reviews. But this competition runs <strong>**every week.**</strong> Next week, will be my week. I will win these airpods!</p><p>And I promptly moved on and completely forgot about it.</p><p>But as it happens I was building out an express app that week, so I ended up landing on OpenBase quite frequently, and I was actually using a bunch of these packages, basing some of those decisions on the data presented. So writing two tweets worth of review on the experience was hardly a job, and I’m all for helping the next dev avoid the same problems. (I even submit PRs for bad docs &amp;&amp; readme’s!!!)</p><h3>Game on, a strong defense</h3><p>There were 4 or 5 days on the clock this round. And only one user on the leaderboard, with a single review to their name. I decided upon a strategy, based on last weeks experience. When I saw the leaderboard, with someone 11 reviews ahead, it discouraged me from competing. So I decided to bash out 9 reviews, put myself at the top of the leaderboard and scare away competitors. I didn’t just pump them out in one sitting, but over the day, each package I added (or had previously added, but did some work with) I quickly threw up a review while the experience was fresh.</p><p>I primarily focused on why I’d chosen this package over another, or how it compared to one that enabled the same use case. Those ‘ah ha’ moments that occur after using something for a little while, but are not clear from the first pass of the docs.</p><p>The strategy worked, no one was competing with me over the next 3 days.</p><h3>High Noon, Bot Showdown</h3><p>With 24–48 hours to go, things started heating up. Overnight, Vicky &amp; Suraj had made it a competition.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*UbNH4SlRyiky2uSub49woA.png" /><figcaption>Vicky “very suspicious” Bhosale. P.S Don’t use your initials for you 2nd account…</figcaption></figure><p>But upon looking a little closer, something did’t seem right. For one, they clearly hadn’t used github to login (or their github profiles were empty) and their reviews… well their reviews were weak. Poor english, non sensical, garbage really. And they had VOTES! (reviews are worth 10 points, votes 1. I was running an all reviews strategy here).</p><p>Pretty suspiciously, I’d say obviously, bots. Which hey, I expected. But I was expected the quality to be a bit higher. These seemed too obvious.</p><p>Credit to open base, within a few hours, these accounts were removed. And I was back on top! This also game me some confidence that there was any value in continuing.</p><p>Hilariously, after these bot accounts were removed, I received a flood of upvotes across all my reviews, from the same accounts that had upvoted for the bots. Either a) they we’re playing the sabotage game, trying to take my account down as a bot as well. Or, and more likely, b) their bot game was so weak they weren’t even validating they account to vote for, and rather just voted account on top of the leaderboard (which a few hours earlier had been their bot).</p><p>Either way, Cheers!! :)</p><p>Round 2 of the bots came in the last 4–6 hours. Suddenly new competitors were racing to the top, with more low value bulllllsh**t reviews. I mean, one left the `”` marks before and after their reviews which was…. well…. obvious…</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*jxsSBnLsKELwLKX_VBA6cA.png" /><figcaption>Maybe try an avatar, a bio, you know… even a hint of authenticity…</figcaption></figure><p>With a few hours to go (11ish NZ time) I threw in a final review to tie it up, 170 points a piece and went to bed. I knew full well these bots would be removed, but it gave me a smug sense of pride to beat the bots without cheating. I imagine anyone who beat Lance Armstrong feels the same.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*QhMUfpxYBTB_LxUHtToW9Q.jpeg" /><figcaption>My winnings, first prize!</figcaption></figure><p>And now I have free Airpods! Big shoutout to the OpenBase team, and good luck with the product. I know I’ve continued using it since, and will continue to. Looking forward to seeing what the next version offers. I know when I was in DevRel this was the kind of site that I would have made my homepage.</p><p>Hilariously, my airpods arrived within a few days from the states, with another package from the states that I ordered <strong>**5 MONTHS AGO**</strong>. Welcome to New Zealand.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=be6bc7fb81ef" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[IBM MAX Image Caption Library Examples]]></title>
            <link>https://riley-james.medium.com/ibm-max-image-caption-library-examples-31ead6e6ddd0?source=rss-a2a16bfb4383------2</link>
            <guid isPermaLink="false">https://medium.com/p/31ead6e6ddd0</guid>
            <category><![CDATA[ibm-model-asset-exchange]]></category>
            <category><![CDATA[ibm-watson]]></category>
            <category><![CDATA[image-captioning]]></category>
            <category><![CDATA[image-classification]]></category>
            <dc:creator><![CDATA[Riley James]]></dc:creator>
            <pubDate>Sat, 23 May 2020 05:27:07 GMT</pubDate>
            <atom:updated>2020-05-23T05:27:07.731Z</atom:updated>
            <content:encoded><![CDATA[<p>I was looking for an image captioning solution for a few images. <em>IBM’s MAX image caption library</em> was the first one I found, results, not great. Pretty terrible on these kinds of images really.</p><p>IBM’s Max Image Caption library: <a href="https://github.com/IBM/MAX-Image-Caption-Generator">https://github.com/IBM/MAX-Image-Caption-Generator</a></p><h4>How to use:</h4><pre>$ docker run -it -p 5000:5000 codait/max-image-caption-generator</pre><p>Downloads the image and runs it.</p><p>Then you have a the api exposed locally: <a href="http://0.0.0.0:5000/">http://0.0.0.0:5000</a></p><p>You can use it via curl, like so:</p><pre>curl -F &quot;image=@samples/surfing.jpg&quot; -X POST http://localhost:5000/model/predict</pre><p>Or, you can test it via the swagger documentation:</p><p>Open you browser to: <a href="http://0.0.0.0:5000/">http://0.0.0.0:5000</a></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*BMzSSBG5CAUmpc3sb7IyLQ.png" /></figure><h3>Some Image &amp; Response Examples:</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*ehj8INUNnkw1wbONOZtGJQ.jpeg" /></figure><pre>{<br> “status”: “ok”,<br> “predictions”: [<br> {<br> “index”: “0”,<br> “caption”: “a bunch of green bananas hanging from a tree .”,<br> “probability”: 0.004498371145962152<br> },<br> {<br> “index”: “1”,<br> “caption”: “a bunch of bananas hanging from a tree .”,<br> “probability”: 0.0026828066468930407<br> },<br> {<br> “index”: “2”,<br> “caption”: “a bunch of bananas growing on a tree .”,<br> “probability”: 0.0008265803491343649<br> }<br> ]<br>}</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*v7_k7vnNjloW9-LQbnfctA.jpeg" /></figure><pre>{<br> “status”: “ok”,<br> “predictions”: [<br> {<br> “index”: “0”,<br> “caption”: “a group of birds standing on top of a beach .”,<br> “probability”: 0.0009019170389011701<br> },<br> {<br> “index”: “1”,<br> “caption”: “a group of birds standing on top of a sandy beach .”,<br> “probability”: 0.0008502319491804747<br> },<br> {<br> “index”: “2”,<br> “caption”: “a group of birds sitting on top of a beach .”,<br> “probability”: 0.0006056828923520915<br> }<br> ]<br>}</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*A6uhoKu_vJpDqhxc2WuLSQ.jpeg" /></figure><pre>{<br> “status”: “ok”,<br> “predictions”: [<br> {<br> “index”: “0”,<br> “caption”: “a close up of a pair of scissors”,<br> “probability”: 0.00263403752634752<br> },<br> {<br> “index”: “1”,<br> “caption”: “a close up of a pair of scissors on a table”,<br> “probability”: 0.0004045068084737849<br> },<br> {<br> “index”: “2”,<br> “caption”: “a close up of a stuffed animal on a table”,<br> “probability”: 0.00013753994480485387<br> }<br> ]<br>}</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*MWLtIV93BzKvhLfsiF0K1Q.jpeg" /><figcaption>A funny looking pair of scissors</figcaption></figure><pre>{<br> “status”: “ok”,<br> “predictions”: [<br> {<br> “index”: “0”,<br> “caption”: “a close up of a pair of scissors”,<br> “probability”: 0.00032490566885802724<br> },<br> {<br> “index”: “1”,<br> “caption”: “a close up of a person holding a kite”,<br> “probability”: 0.00017438483190880002<br> },<br> {<br> “index”: “2”,<br> “caption”: “a close up of a pair of scissors on a table”,<br> “probability”: 0.00006401656661012868<br> }<br> ]<br>}</pre><h4>Conclusion:</h4><p>Useless. Cool. Back to the drawing board. Obviously the dataset used to train the model is not suitable for the dataset I’m trying to caption.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=31ead6e6ddd0" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[How to download zoom & set a virtual background]]></title>
            <link>https://riley-james.medium.com/how-to-download-zoom-set-a-virtual-background-b76e64f711f3?source=rss-a2a16bfb4383------2</link>
            <guid isPermaLink="false">https://medium.com/p/b76e64f711f3</guid>
            <dc:creator><![CDATA[Riley James]]></dc:creator>
            <pubDate>Mon, 04 May 2020 08:13:46 GMT</pubDate>
            <atom:updated>2020-05-06T02:56:02.318Z</atom:updated>
            <content:encoded><![CDATA[<p>So you’re invited to a super surprise party and you need to prepare for the virtual event. The good news, getting dressed is 50% faster! Just throw on your favourite party shirt and you’re good to go. Shoes, socks and pants are always optional at a zoom party.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*2gswyE-CaZrYLAxtLVyDww.jpeg" /><figcaption>Pros only. Make sure you know where that camera’s pointed at all times!</figcaption></figure><h4>But you will need two important things:</h4><ol><li>Download Zoom, NOW! Not on the day. (unless you downloaded it within the last month or so, you should also try updating it)</li><li>Download our chosen virtual background and apply it (again, before the big day)</li></ol><p>Here are your instructions for getting these two steps done. Any problems, just shoot an email to our tech support lead: TryTurningItOffAndOnAgain@RileyJames.co</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/500/1*44628vsCHrm9Lew-oVixIQ.gif" /></figure><h4>How to setup a virtual background?</h4><p>First up, what is a virtual background? It’s a special effect for Zoom which superimposes your face/body on top of a background of your choice. It’s like standing in front of a green screen! In order to use a virtual background you must have a zoom account (which is free to create).</p><p>This is the virtual background we’ve chosen:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*tRduvumlwH1_osA0u0zBZQ.jpeg" /><figcaption>Havana, Cuba</figcaption></figure><p>You can download it here: <a href="https://imgur.com/download/b1QefhL">https://imgur.com/download/b1QefhL</a></p><p>It’s also attached to the email.</p><h4>How to download, install &amp; setup Zoom:</h4><p>I’ve included instructions for each system below.</p><h4>Windows / Mac / Macbook</h4><ol><li>Save the virtual background to your computer: <a href="https://imgur.com/download/b1QefhL">https://imgur.com/download/b1QefhL</a></li><li>Visit the Zoom Download Page: <a href="https://zoom.us/download">https://zoom.us/download</a></li></ol><p>3. Click download</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*9iydXm5-MyL-6LJQtB5v3A.png" /><figcaption>The big download button, say no more, say no more.</figcaption></figure><p>4. Once you’ve installed Zoom, open it.</p><p>5. In order to use a virtual background you will need an account (free). If you have one, sign in, if not, create one.</p><p>5. Now that you have signed in, click on your profile picture and then click “Settings”.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/281/1*TAysvj0Onb7_fnNssHNiUw.png" /><figcaption>Click on your Profile picture and then click “Settings”</figcaption></figure><p>6. Click “Virtual Background”. Do NOT click “I have a green screen”.</p><p>7. Now you can add your virtual background. Click the plus symbol, select “add image” and then select the virtual background we downloaded earlier.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/640/1*ogVyXEc02P0GuXlj8tzvtA.png" /></figure><p>You can now see a preview of your camera with the virtual background. It’s pretty good, but not perfect. While it doesn’t have to be perfect, you will find different results based on what’s behind you. A wall of one solid colour should work best.</p><h4>iPhone / iPad:</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/828/1*1UdegYglpVKEkLRhWgf59A.jpeg" /><figcaption>How to save an image on iPhone / iPad</figcaption></figure><ol><li>Save the virtual background to your photos: <a href="https://imgur.com/download/b1QefhL">https://imgur.com/download/b1QefhL</a></li><li>To save the image, tap and hold on the image, then select “Save Image” (see above)</li><li>Download Zoom: <a href="https://itunes.apple.com/us/app/id546505307">https://itunes.apple.com/us/app/id546505307</a></li><li>Once downloaded, open the application</li><li>Create a free zoom account or sign into your existing account</li><li>For iPhone / iPad you can only setup a virtual background while you’re in a meeting. So tap “New Meeting”, then “Start a Meeting”</li><li>Now tap the “… More” button in the bottom right corner, and then “Virtual Background”</li><li>Press the plus button and select the photo you saved earlier.</li><li>You can now preview how your virtual background will look.</li></ol><p>Note: Your background will be setup for every meeting you join now, so if you have other meetings coming up you may wish to choose “None” until the date of the party :)</p><h4>Android Phone / Tablet:</h4><ol><li>Download Zoom: <a href="https://play.google.com/store/apps/details?id=us.zoom.videomeetings">https://play.google.com/store/apps/details?id=us.zoom.videomeetings</a></li></ol><figure><img alt="" src="https://cdn-images-1.medium.com/max/768/1*4UKxySNakDFrh1WFlvFUeA.gif" /></figure><p>2. Unfortunately virtual backgrounds are not supported for Zoom on Android. You should send them an angry email.</p><h3>And you’re done!</h3><p>See you at the party!</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/480/1*fmBVrhTtbdHQHiXTPYnnEg.gif" /></figure><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=b76e64f711f3" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[SXSW 2019 St David’s Sanctuary singer songwriter picks]]></title>
            <link>https://riley-james.medium.com/sxsw-2019-st-davids-sanctuary-singer-songwriter-picks-99644809f16b?source=rss-a2a16bfb4383------2</link>
            <guid isPermaLink="false">https://medium.com/p/99644809f16b</guid>
            <category><![CDATA[stdavidssanctuary]]></category>
            <category><![CDATA[sxsw19]]></category>
            <category><![CDATA[sxsw]]></category>
            <category><![CDATA[singer-songwriter]]></category>
            <category><![CDATA[austin]]></category>
            <dc:creator><![CDATA[Riley James]]></dc:creator>
            <pubDate>Sat, 09 Mar 2019 17:55:30 GMT</pubDate>
            <atom:updated>2019-03-09T17:55:30.295Z</atom:updated>
            <content:encoded><![CDATA[<p>Quick rundown of some of the must see artists playing at St David’s Sanctuary at SXSW 2019.</p><h4>Madison Cunningham</h4><p>Beauty into cliches is a ripping track. Strong Margaret Glaspy vibes. Love it! Can’t wait to see the live show. Playing March 13th.</p><iframe src="https://cdn.embedly.com/widgets/media.html?src=https%3A%2F%2Fwww.youtube.com%2Fembed%2F7iRWYghla8s%3Ffeature%3Doembed&amp;url=http%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3D7iRWYghla8s&amp;image=https%3A%2F%2Fi.ytimg.com%2Fvi%2F7iRWYghla8s%2Fhqdefault.jpg&amp;key=a19fcc184b9711e1b4764040d3dc5c07&amp;type=text%2Fhtml&amp;schema=youtube" width="854" height="480" frameborder="0" scrolling="no"><a href="https://medium.com/media/fcbcf6bc900ddc5a6b3f3b6a08dd90b8/href">https://medium.com/media/fcbcf6bc900ddc5a6b3f3b6a08dd90b8/href</a></iframe><h4>Willie J Healey</h4><p>Haunting song writing from Willie puts this straight on my must see list. Have a listen to 666 Kill to see what I mean. Playing March 14th.</p><iframe src="https://cdn.embedly.com/widgets/media.html?src=https%3A%2F%2Fwww.youtube.com%2Fembed%2FqeR-b05FixQ%3Ffeature%3Doembed&amp;url=http%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DqeR-b05FixQ&amp;image=https%3A%2F%2Fi.ytimg.com%2Fvi%2FqeR-b05FixQ%2Fhqdefault.jpg&amp;key=a19fcc184b9711e1b4764040d3dc5c07&amp;type=text%2Fhtml&amp;schema=youtube" width="854" height="480" frameborder="0" scrolling="no"><a href="https://medium.com/media/13d7d18732ce78d727e6bfe318ccf29e/href">https://medium.com/media/13d7d18732ce78d727e6bfe318ccf29e/href</a></iframe><h4>Novo Amor</h4><p>If you loved Bon Ivor’s Holocene, Novo Amor is your man. Sweet folk tunes with auto tune vocal goodness. Playing March 15th.</p><iframe src="https://cdn.embedly.com/widgets/media.html?src=https%3A%2F%2Fwww.youtube.com%2Fembed%2FOmKAn8rNbKg%3Ffeature%3Doembed&amp;url=http%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DOmKAn8rNbKg&amp;image=https%3A%2F%2Fi.ytimg.com%2Fvi%2FOmKAn8rNbKg%2Fhqdefault.jpg&amp;key=a19fcc184b9711e1b4764040d3dc5c07&amp;type=text%2Fhtml&amp;schema=youtube" width="854" height="480" frameborder="0" scrolling="no"><a href="https://medium.com/media/f00883a07eaee424f225286cdf26c860/href">https://medium.com/media/f00883a07eaee424f225286cdf26c860/href</a></iframe><h4>Celeste</h4><p>Soulful songstress with some Amy Winehouse esque vocals. Moody tones in the beats &amp; backing fill out the soundscape perfectly. Playing March 15th.</p><iframe src="https://cdn.embedly.com/widgets/media.html?src=https%3A%2F%2Fwww.youtube.com%2Fembed%2FU4kYS2d23h8%3Ffeature%3Doembed&amp;url=http%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DU4kYS2d23h8&amp;image=https%3A%2F%2Fi.ytimg.com%2Fvi%2FU4kYS2d23h8%2Fhqdefault.jpg&amp;key=a19fcc184b9711e1b4764040d3dc5c07&amp;type=text%2Fhtml&amp;schema=youtube" width="854" height="480" frameborder="0" scrolling="no"><a href="https://medium.com/media/82cf9833d4f639a4d969dec362240ba6/href">https://medium.com/media/82cf9833d4f639a4d969dec362240ba6/href</a></iframe><h4>Angie McMahon</h4><p>Angie “Yells words into microphone”, but does it so well. She’s got a powerful voice. And from Melbourne to boot. Let’s hear it. Playing March 15th.</p><iframe src="https://cdn.embedly.com/widgets/media.html?src=https%3A%2F%2Fwww.youtube.com%2Fembed%2FE8wfc5vdBTs%3Ffeature%3Doembed&amp;url=http%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DE8wfc5vdBTs&amp;image=https%3A%2F%2Fi.ytimg.com%2Fvi%2FE8wfc5vdBTs%2Fhqdefault.jpg&amp;key=a19fcc184b9711e1b4764040d3dc5c07&amp;type=text%2Fhtml&amp;schema=youtube" width="854" height="480" frameborder="0" scrolling="no"><a href="https://medium.com/media/283bc8ff2ee17146a2b030f88bccfd5d/href">https://medium.com/media/283bc8ff2ee17146a2b030f88bccfd5d/href</a></iframe><p>And that’s just a few favourites, there’s plenty more on stage. I’ve made a playlist of everyone playing over the three nights, check it out and find your own favourites: https://open.spotify.com/user/rrrrrrrj/playlist/2aHckcukaySiADvd84Cxlp?si=QDTfc0XZRGOjEoMBvpkKpg</p><p>Also if you want a great playlist for the whole fest, check out this one out together by <a href="https://medium.com/u/13405754c56e">Songpickr </a>https://open.spotify.com/user/holgerchristoph/playlist/6EkT5lqixm79KLO9lUjPVz?si=Y5q8w_14Q0WiveiEUhz2AQ</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=99644809f16b" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Creating an immutable audit trail on the blockchain with Xero & Tierion]]></title>
            <link>https://devblog.xero.com/creating-an-immutable-audit-trail-on-the-blockchain-with-xero-tierion-be423d39380b?source=rss-a2a16bfb4383------2</link>
            <guid isPermaLink="false">https://medium.com/p/be423d39380b</guid>
            <category><![CDATA[bitcoin]]></category>
            <category><![CDATA[developer]]></category>
            <category><![CDATA[api]]></category>
            <category><![CDATA[accounting]]></category>
            <category><![CDATA[blockchain]]></category>
            <dc:creator><![CDATA[Riley James]]></dc:creator>
            <pubDate>Thu, 19 Apr 2018 15:01:19 GMT</pubDate>
            <atom:updated>2019-06-26T22:58:26.241Z</atom:updated>
            <content:encoded><![CDATA[<p>There is far more to blockchain technology than the price of bitcoin. This post &amp; PoC project will explore a real use case of blockchain technology. While this is just a proof of concept to show what you can do with Xero’s API, it’s possible to implement this feature yourself.</p><p><strong>For context:</strong> <a href="https://www.xero.com/">Xero</a> is cloud-based (SaaS) small business accounting software. Business owners use it to manage their business while accountants and bookkeepers use it to provide business advisory &amp; compliance services to their small business clients.</p><iframe src="https://cdn.embedly.com/widgets/media.html?src=https%3A%2F%2Fwww.youtube.com%2Fembed%2F11mBUE5cNas%3Ffeature%3Doembed&amp;url=http%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3D11mBUE5cNas&amp;image=https%3A%2F%2Fi.ytimg.com%2Fvi%2F11mBUE5cNas%2Fhqdefault.jpg&amp;key=a19fcc184b9711e1b4764040d3dc5c07&amp;type=text%2Fhtml&amp;schema=youtube" width="854" height="480" frameborder="0" scrolling="no"><a href="https://medium.com/media/250ba9e40c8f6df5d3a6d2c5fa71a988/href">https://medium.com/media/250ba9e40c8f6df5d3a6d2c5fa71a988/href</a></iframe><h4><strong>Audit in Accounting:</strong></h4><p>An audit is a common process within the accounting world. The Australian Taxation Office (ATO) regularly audits businesses to ensure they’ve declared the correct amount of tax. Publicly listed companies (like <a href="https://www.marketindex.com.au/asx/xro">Xero</a>) are required to conduct regular audits to ensure their financial statements are accurate. Any accusation of fraud or dishonest activity within business will likely lead to an audit. And in many cases, audits are simply performed at random to ensure legal, accounting &amp; regulatory compliance.</p><h4>Xero’s History and Notes Feature:</h4><p>Xero has a ‘History and Notes’ feature which records changes made to an accounting document. Each entry contains details on who made the change, the time and date the change was made, and some details regarding what was changed.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*hNeC7051wSHNebZEgU8glA.png" /><figcaption>An example of the history and notes feature on an invoice</figcaption></figure><p>This feature works well for business owners and accountants to easily see when a record was last updated and by whom.</p><p>What it doesn’t display is a copy of the transaction at the time of the change — think Github which tracks all the changes to your code base over time. That level of detail might be useful to a 3rd party system conducting an audit.</p><p>And it doesn’t provide immutable proof that the document (or it’s history) hasn’t otherwise changed. Ultimately, these history and notes entries are simply entries in a database, they’re not immutable, and they’re not independently verifiable.</p><h4>An Immutable Audit Trail:</h4><p>A person can do some research and come to a conclusion regarding their level of trust for an organisation. And determine if they should trust the data they’ve received.</p><p>Audits, regulation, public companies, stock markets, rule of law, freedom of the press, and I’m sure you can think of others. These are all mechanisms which assist people to determine who and what to trust, and to what level.</p><p>But, all these mechanisms are built, maintained &amp; enforced by people. Software struggles to parse these systems, and the incentives they create for people to follow, or not follow them.</p><p>Therefore, it is difficult for software to verify the integrity of data it receives when this datas’ integrity is enforced through such mechanisms.</p><blockquote><strong>immutable</strong>: unchanging over time or unable to be changed.</blockquote><p>Blockchains* create a new set of incentives, which can be verified easily by a piece of software. It’s these incentives that enable an immutable database of entries, which in turn enables the production of an immutable audit trail.</p><p>If you’re interested in more details on why it’s so difficult to change entries within a blockchain, <a href="https://bitsonblocks.net/2016/02/29/a-gentle-introduction-to-immutability-of-blockchains/">this article provides some great examples</a>.</p><p>Can data be changed, <em>technically, yes</em>, but such an event would be easily recognised by humans &amp; computers alike. On top of that, participants in the chain are incentivised against changing existing entries.</p><p><em>*Note: I am referring to public blockchains such as Bitcoin &amp; Ethereum. There are many other types of blockchains, which may have different incentives, for different purposes.</em></p><h3>Enter Tierion:</h3><p>Tierion developed the Chainpoint protocol to enable applications to link data to a blockchain. This is commonly called “anchoring”. Each Chainpoint proof lets you verify the integrity and timestamp of information without relying on a trusted third-party.</p><h4>How does the Chainpoint protocol work?</h4><p>In order to attach data to a blockchain, first create a SHA-256 hash of the data. The hash of the data can then submitted to a Chainpoint node that is running the Chainpoint protocol.</p><p>The Chainpoint protocol bundles up many of these SHA-256 hashes into a Merkle tree. The use of a <a href="https://en.wikipedia.org/wiki/Merkle_tree">Merkle tree</a> allows a large number of hashes (representing an event larger amount of data) to be attached a blockchain through a single entry, also known as a “merkle root”.</p><p>The Merkle root produced is then anchored to a public blockchain (Currently BTC &amp; Tierion’s internal Calendar — CAL).</p><p>Chainpoint returns a proof that contains the SHA-256 hash of the data, and cryptographic proof that the SHA-256 hash is contained in the Merkle root. It also contains the blockchain (BTC &amp; CAL) transactions that anchor the Merkle root to a blockchain, proving it’s existence at the exact point in time.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*yQamMOjbRZcqVuulwrFdBA.png" /><figcaption>Chainpoint protocol in action. Note: Chainpoint does not currently support the ethereum blockchain. Image source: <a href="https://chainpoint.org/">Chainpoint.org</a></figcaption></figure><p>With this process is it now possible to prove that the data existed at a specific date/time and has not been modified since. This can all be done without ever making the original data publicly available, thanks to the SHA-256 hashing &amp; encryption.</p><h4>The Crypto Audit</h4><p>If ever audited by the ATO in the future, it is now far easier. Each piece of data has it’s own SHA-256 hash and Chainpoint proof that provides all the information needed.</p><p>Technically, the original SHA-256 hash would not even need to be provided, as the auditor could generate this themselves from the original data source (and the auditor should, <a href="https://en.wikipedia.org/wiki/Trust,_but_verify">trust, but verify</a>).</p><p>The provided Chainpoint proof could then be evaluated against each blockchain it was anchored to, in order to verify that the transaction exists, in turn proving the given hash exists, untampered with.</p><p>This entire data collection &amp; evaluation process could be completed by an application, and later verified by a human manually (if necessary). There are only two possible outcomes:</p><p>The data provided generates a SHA-256 hash that matches the Chainpoint proof and can be evaluated against a public blockchain.</p><p><em>Or it does not.</em></p><p>There are no 3rd parties to trust and there are no factors that can not be evaluated by an algorithm.</p><h3>Why use Tierion’s Chainpoint Technology?</h3><p>You certainly don’t need to, you could simply hash your document/data and put it directly onto a blockchain. The Chainpoint protocol makes the entire process cheaper &amp; easier to implement.</p><p>Chainpoint’s advantages are:</p><ul><li>Economies of scale: The Merkle tree implementation allows a large number of hashes to be aggregated and anchored within a single transaction. Chainpoint’s aggregation reduces the cost of anchoring data while increasing the amount of data that can be anchored at one time.</li><li>Anchors against multiple blockchains. Currently only Bitcoin &amp; Tierion’s internal Calendar (CAL), but I’d expect others to be adopted as the blockchain ecosystem develops.</li><li>Creates ‘Chainpoint proofs’. These proofs allow anyone to verify their data independently, without relying on Tierion.</li><li>Doesn’t require owning currency/tokens to use.</li><li>Abstracts away from blockchain specific features / implementations. ie: transaction speed, transaction costs, api changes</li><li>Ease of implementation: SDK written in JS, inevitably more languages will be supported in the future.</li><li>Does not require infrastructure, management of network nodes or storage of a complete blockchain.</li></ul><h3>Building a ‘Proof of Concept’ immutable audit history for Xero invoices</h3><p>So hopefully you now understand why I’m using a blockchain, and what I’m attempt to achieve with it. Now lets look at how we can put that into practice.</p><p>The goal was to build an application that utilised Xero’s API &amp; Tierion’s blockchain technology to create an immutable audit trail. As it’s only a proof of concept, I chose deliberately limited the scope to a single accounting document, <a href="https://developer.xero.com/documentation/api/invoices">Invoices</a>.</p><p>I chose to build the sample application in Node, primarily because there is a <a href="https://www.npmjs.com/package/chainpoint-client">Node SDK for the Chainpoint protocol</a>, but also because Xero has a relatively new <a href="https://github.com/XeroAPI/xero-node">Node SDK</a> (and since beginning this project, <a href="https://github.com/XeroAPI/xero-node/tree/v3">we have an even newer one under development</a> :) and I needed an excuse to have a play.</p><h4>False Start:</h4><p>I initially built out a prototype based on the documentation on the Tierion website. It was an incredibly basic version, built without any SDK’s, as a single Lambda function (in python).</p><p>This first version was modelled on my previous PoC, <a href="https://medium.com/@riley.james/sending-a-xero-invoice-by-fax-with-phaxio-a954b62c0407">sending invoices via Fax with Phaxio</a>. The lambda function processed invoice webhooks, retrieved the invoice, hashed it and submitted it to Tierion’s API.</p><h3>Riley James on Twitter</h3><p>Boom, it&#39;s valid. @Tierion PoC for @XeroAPI accounting documentation validation / proof of existence coming soon: https://t.co/RqxsuNI9ds #BlockChain #Xero #ProofOfExistence</p><p>I tweeted the resulting valid receipt, and the Tierion team reached out. Unfortunately they informed me that I had built against v2 of the Chainpoint protocol, and that a <a href="https://chainpoint.org/">new v3 of the Chainpoint protocol</a> was already available.</p><p>It was time to go back to the drawing board, and build it again, oh no ;)</p><h4>Going Node</h4><p>For the second version I decided I wanted to move away from Lambda functions and build a full app. And having built my last two sample projects in Python, I was keen to try something new, so Node it was.</p><p>Check out the Github repo: <a href="https://github.com/rjaus/XeroTierion">https://github.com/rjaus/XeroTierion</a></p><p>I also wanted to keep it super light, and not use any databases. This ended up being a bit of pain, but a great learning experience. Instead of using a database, I planned to to use Xero Files / Attachment feature to store the audit data along side Xero’s invoices. By the end of the project I was storing a lot more data than I initially through I’d need to, so this became a little convoluted. But from a users perspective, I think it makes most sense to keep the data in Xero along side the invoices, where a user can easily find it, and would expect it to be.</p><h4>How does it work?</h4><p>The Audit History application uses Xero API webhooks to listen for creation &amp; change events on invoices within Xero.</p><p>When a creation or change events is delivered to the application via a webhook event, it initiates the process of creating an immutable audit trail.</p><ol><li>The full invoice data is retrieved from the Xero API</li><li>The invoice data is hashed with SHA-256</li><li>The <a href="https://github.com/chainpoint/chainpoint-client-js#submithasheshashes-uris-callback">hash is submitted</a> to 2 Chainpoint nodes using the Chainpoint v3 protocol</li><li>The CAL proof is retrieved from the 2 Chainpoint nodes and stored as an attachment against the invoice in Xero</li><li>The BTC proof is retrieved from the 2 Chainpoint nodes and stored as an attachment against the invoice in Xero (BTC proof can only be generated after the transaction has been created in the Bitcoin blockchain — this takes approximately 90–120 minutes after submitting the hash)</li><li>The user can now retrieve the proofs (BTC &amp; CAL) from the invoice in Xero (proofs are stored as attachments) and verify them. In our app, the proofs are then displayed along side the Xero invoice data (the audit history), along with the verified proof.</li></ol><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*-A31rHwv_eiRwqHlpw-CGw.png" /><figcaption>Invoice Audit History Sample App</figcaption></figure><h4>So how does this prove our Immutable Audit History?</h4><p>So now that we’ve hashed our data and submitted it to Chainpoint, how does that prove to the user that the invoice data existed, and has not been modified?</p><p>The verified proof, generated with Chainpoint, proves that the hash has been included in the Merkle tree and includes the timestamp of when it was submitted to Tierion. The Merkle root and the Bitcoin block ID are provided to the user.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*GcmR9sEsWV_NtVKlpovBUg.png" /><figcaption>Verified Proof with timestamp, Merkle root &amp; Bitcoin block ID highlighted</figcaption></figure><p>Any user can then take the Bitcoin block ID and put it into any 3rd party blockchain explorer (or use a local copy of the blockchain).</p><ul><li><a href="https://live.blockcypher.com/btc/block/514177">Block: 514177 on BlockCypher.com</a></li><li><a href="https://blockexplorer.com/block/000000000000000000500e46c91e6ab703a1cc5dd5635522b5297a5bd9626c43">Block: 514177 on BlockExplorer.com</a></li><li><a href="https://blockchain.info/block/000000000000000000500e46c91e6ab703a1cc5dd5635522b5297a5bd9626c43">Block: 514177 on Blockchain.info</a></li><li><a href="https://www.blocktrail.com/BTC/block/514177">Block: 514177 on Blocktrail.com</a></li></ul><p>The Merkle root value from the Chainpoint proof should match that displayed from the Bitcoin block explorer.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*HuQrHA-z0yBsPS93INUpLw.png" /><figcaption>Block Cypher Bitcoin Blockchain Explorer <a href="https://live.blockcypher.com/btc/block/514177">#514177</a></figcaption></figure><p>We now have proof of existence.</p><p>This invoice data:</p><pre>{ &quot;Type&quot;: &quot;ACCREC&quot;, &quot;Contact&quot;: { &quot;ContactID&quot;: &quot;152fd4d9-08e7-48fd-b8f7-0d04674f2fd0&quot;, &quot;ContactStatus&quot;: &quot;ACTIVE&quot;, &quot;Name&quot;: &quot;Blockchain Auditor&quot;, &quot;EmailAddress&quot;: &quot;&quot;, &quot;BankAccountDetails&quot;: &quot;&quot;, &quot;Addresses&quot;: [ { &quot;City&quot;: &quot;&quot;, &quot;Region&quot;: &quot;&quot;, &quot;PostalCode&quot;: &quot;&quot;, &quot;Country&quot;: &quot;&quot;, &quot;AddressType&quot;: &quot;STREET&quot; }, { &quot;City&quot;: &quot;&quot;, &quot;Region&quot;: &quot;&quot;, &quot;PostalCode&quot;: &quot;&quot;, &quot;Country&quot;: &quot;&quot;, &quot;AddressType&quot;: &quot;POBOX&quot; } ], &quot;Phones&quot;: [ { &quot;PhoneNumber&quot;: &quot;&quot;, &quot;PhoneAreaCode&quot;: &quot;&quot;, &quot;PhoneCountryCode&quot;: &quot;&quot;, &quot;PhoneType&quot;: &quot;DEFAULT&quot; }, { &quot;PhoneNumber&quot;: &quot;&quot;, &quot;PhoneAreaCode&quot;: &quot;&quot;, &quot;PhoneCountryCode&quot;: &quot;&quot;, &quot;PhoneType&quot;: &quot;DDI&quot; }, { &quot;PhoneNumber&quot;: &quot;&quot;, &quot;PhoneAreaCode&quot;: &quot;&quot;, &quot;PhoneCountryCode&quot;: &quot;&quot;, &quot;PhoneType&quot;: &quot;FAX&quot; }, { &quot;PhoneNumber&quot;: &quot;&quot;, &quot;PhoneAreaCode&quot;: &quot;&quot;, &quot;PhoneCountryCode&quot;: &quot;&quot;, &quot;PhoneType&quot;: &quot;MOBILE&quot; } ], &quot;IsSupplier&quot;: false, &quot;IsCustomer&quot;: true, &quot;DefaultCurrency&quot;: &quot;AUD&quot; }, &quot;LineItems&quot;: [ { &quot;Description&quot;: &quot;A hash of this invoice will end up in the blockchain.&quot;, &quot;Quantity&quot;: 1, &quot;UnitAmount&quot;: 1000, &quot;AccountCode&quot;: &quot;200&quot;, &quot;TaxType&quot;: &quot;OUTPUT&quot;, &quot;TaxAmount&quot;: 100, &quot;LineAmount&quot;: 1000 } ], &quot;Date&quot;: &quot;2018-02-23T00:00:00.000Z&quot;, &quot;DueDate&quot;: &quot;2018-02-24T00:00:00.000Z&quot;, &quot;LineAmountTypes&quot;: &quot;Exclusive&quot;, &quot;InvoiceNumber&quot;: &quot;XRO-TNT-1&quot;, &quot;Reference&quot;: &quot;tierion-chainpoint-2&quot;, &quot;BrandingThemeID&quot;: &quot;dfe23d27-a3a6-4ef3-a5ca-b9e02b142dde&quot;, &quot;CurrencyCode&quot;: &quot;AUD&quot;, &quot;CurrencyRate&quot;: 1, &quot;Status&quot;: &quot;DRAFT&quot;, &quot;SentToContact&quot;: false, &quot;SubTotal&quot;: 1000, &quot;TotalTax&quot;: 100, &quot;Total&quot;: 1100, &quot;InvoiceID&quot;: &quot;9f950cfe-1cb6-4422-8a8f-49725bd9e914&quot;, &quot;HasAttachments&quot;: false, &quot;AmountDue&quot;: 1100, &quot;AmountPaid&quot;: 0 }</pre><p>Represented by it’s SHA-256 hashed value of:</p><pre>9ec53ce79305e4c4c77aab08d0ba95a75be68923e76bcbc7e7c16274c98772c8</pre><p>Was submitted to a Chainpoint node at:</p><pre>2018-03-19T01:48:46Z</pre><p>Was included in the Merkle tree with a root of:</p><pre>7252a3f8c1cc4726341687cdaf85a2b4dc0bd85d86e2de70255229d453c86f56</pre><p>Which was attached to Bitcoin block:</p><pre>514177</pre><p>This becomes the first entry in our immutable audit history for this invoice.</p><h3>Immutable Audit History:</h3><p>Any further changes to an invoice which will be picked up by the audit history app (through webhooks) and taken through the same process, adding a new entry to the audit history.</p><p><strong>Some of the reasons it’s immutable:</strong></p><ul><li>Attempting to change the data of an invoice that has already been included in the audit history will result in a different hash being generated.</li><li>Attempting to modify the timestamp, Merkle root or Bitcoin block ID will result in a mismatch between the verified proof provided, and that which would be generated with the Chainpoint protocol.</li><li>Re-hashing the data and submitting it to Tierion will result in a new timestamp, and a new (more recent) entry in the audit history</li><li>Attempting to modify the Merkle root, as recorded in the Bitcoin block would require forking of the Bitcoin blockchain</li></ul><h3>PoC to Product:</h3><p>Taking this from a proof of concept to a product would require a lot of polishing. There plenty of features to be added to make it usable for a technical user.</p><h4><strong>Xero Files as a Database — XFAAD:</strong></h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*7Kkw0dIZz_kh5hTCF-prTg.png" /><figcaption>Xero Files do not provide previews of text files. Downloading the file is required to view the contents.</figcaption></figure><p>Xero Files is not a database. The primary reason I did this was to keep everything in Xero, but that provides little value when text files are not browsable in the UI. Only images &amp; pdf files can be previewed within the UI, text files must be downloaded before they can be viewed.</p><h4><strong>Multi-tenancy:</strong></h4><p>Currently the application uses the <a href="https://developer.xero.com/documentation/auth-and-limits/private-applications">Private App method</a>. This is only suitable for 1:1 connections between and Xero Org and the Xero API. This makes it perfect for PoC / Dev environment, but to make it user friendly it would require the <a href="https://developer.xero.com/documentation/auth-and-limits/partner-applications">Partner App</a>, and to become a multi-tenanted application (so users don’t need to manage infrastructure).</p><h4><strong>Deltas / What’s changed:</strong></h4><p>Knowing that an invoice has changed is a great feature, but the real value coming in knowing what part that invoice has changed. A critical feature of this application would be to determine what has changed, and potentially raise these changes to the user if they particularly noteworthy.</p><h4><strong>One Click Audit:</strong></h4><p>The application currently doesn’t provide any way to export the audit trail. That’s going to be a necessary feature for any kind of useful audit history. Even better, find some way to export it in one click to the ATO / auditing body. The capability to meet audit requirements in a single click would be a massive timesaver for a small business.</p><h4>Audit all the things:</h4><p>An audit trail of invoices is nice, but to be useful it would need to expand to other accounting document types. CreditNotes, BankTransfers, BankTransactions, Payroll, Payments, JournalEntries, the list goes on…</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*2x4O-hmybxh2IrVfgEl9iA.png" /><figcaption>Do not ship, hire a designer</figcaption></figure><h4>Hire a designer:</h4><p>I’m very clearly a developer, not a designer. To make this a product you would need to hide all those long strings and show the user when things match/conflict (at least I colour coded them :) A lot of design work would be required to make this functional for non-developers.</p><h3>And that’s it:</h3><p>If you’ve got questions, reach out on twitter: @<a href="https://twitter.com/RileyJamesAU">RileyJamesAU</a></p><p>Check out the Github repo: <a href="https://github.com/rjaus/XeroTierion">https://github.com/rjaus/XeroTierion</a></p><p>If you want to build something with the Xero API, get in contact: api@xero.com or visit <a href="https://developer.xero.com/">https://developer.xero.com/</a></p><p>-</p><p><em>Over a million small businesses, and their advisors are looking for the best cloud apps that integrate with Xero. </em><a href="https://developer.xero.com/partner/app-partner?utm_source=Medium&amp;utm_medium=Blog&amp;utm_campaign=content_marketing"><em>Partner with us</em></a><em>, and we’ll make sure they find yours.</em></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=be423d39380b" width="1" height="1" alt=""><hr><p><a href="https://devblog.xero.com/creating-an-immutable-audit-trail-on-the-blockchain-with-xero-tierion-be423d39380b">Creating an immutable audit trail on the blockchain with Xero &amp; Tierion</a> was originally published in <a href="https://devblog.xero.com/">Xero Developer</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Growing YC Startups with Xero’s API: W18 Edition]]></title>
            <link>https://devblog.xero.com/growing-yc-startups-with-xeros-api-w18-edition-fa1319649c2?source=rss-a2a16bfb4383------2</link>
            <guid isPermaLink="false">https://medium.com/p/fa1319649c2</guid>
            <category><![CDATA[api-integration]]></category>
            <category><![CDATA[developer]]></category>
            <category><![CDATA[saas]]></category>
            <category><![CDATA[xero]]></category>
            <category><![CDATA[ycombinator]]></category>
            <dc:creator><![CDATA[Riley James]]></dc:creator>
            <pubDate>Wed, 21 Mar 2018 06:54:31 GMT</pubDate>
            <atom:updated>2018-03-22T13:47:00.264Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*69mHK4iYM76IJoOGjV-p5w.jpeg" /></figure><p>YCombinators’s 26th Winter 2018 <a href="https://www.ycombinator.com/demoday/">Demo Day</a> has launched 141 new startups into the world. The startups were pitched to investors over <a href="https://techcrunch.com/2018/03/19/here-are-64-startups-that-launched-today-at-y-combinators-w18-demo-day/">two</a> massive <a href="https://techcrunch.com/2018/03/20/these-are-the-64-startups-unveiled-at-y-combinator-w18-demo-day-2/">days</a>.</p><p>Following <a href="https://devblog.xero.com/growing-yc-startups-with-xeros-api-e392cc405e12">up last years post on YC startups</a>, lets look at which YC startups in the W18 batch could utilise Xero’s API.</p><p>The mix of startups in YC has definitely changed over the years, there are far fewer SaaS / b2b focused startups and far more biomedical, ai &amp; robotics startups. So the list of applicable Xero integrations is becoming a much smaller subset of the overall YC startups.</p><h4><a href="https://getstation.com/">Station</a> — A web browser specifically for saas</h4><p>Easily my favourite startup in this batch of YC companies. I spend my working life in the browser, using a myriad of saas based apps. But the browser wasn’t really built with Saas in mind, and when you intermingle Saas &amp; internet browsing, it just gets worse. Now I can use Chrome to lurk hackers news and Station for #GSD, just how it was meant to be.</p><p>Regarding integration, well they’ve already started, and I’m sure they will do more. Station could also look at integration with <a href="https://www.xero.com/au/features-and-tools/practice-tools/practicemanager/">XPM</a> &amp; <a href="https://www.xero.com/au/features-and-tools/practice-tools/xero-hq/">XeroHQ</a> to create a compelling offering for accountants and bookkeepers.</p><h4><a href="http://onuniverse.com/">Universe</a> — A mobile app for building mobile websites</h4><p>Your typical website builder doesn’t seem like a great fit for a Xero integration. But I doubt it will be long before transactional features are added to the mix, such as eCommerce, ticket sales, event bookings, etc. <a href="https://www.xero.com/us/partnerships/squarespace/">Squarespace</a> integrated their ecommerce tools to Xero, I can see Universe doing the same in time.</p><h4><a href="http://qulture.rocks/">Qulture.Rocks</a> — HR management for Latin America</h4><p>A great match for Xero. Although we haven’t localised our product to LA, or launched payroll for LA countries, we usually see a wave of HR &amp; Payroll related integrations long before we get to these features ourselves (Payroll that is, I do not foresee us providing HR features).</p><h4><a href="http://www.aspire-cap.com/">Aspire</a> — Small business loans in Southeast Asia</h4><p>Small business lending a is a feature we know well, with a <a href="https://www.xero.com/au/marketplace/app-function/s/financial-services/">range of small business lending alternatives</a> to banks integrating into Xero. Currently most of those integrated with Xero are focused on Australia, New Zealand, UK &amp; US. Xero’s current push into Singapore makes this a perfect match for integration, and an opportunity for first movers advantage.</p><h4><a href="https://www.cointracker.io/">CoinTracker</a> — Cryptocurrency portfolio tracking</h4><p>Using a spreadsheet to track your crypto portfolio just seems wrong. Thankfully CoinTracker provides an automated solution to tracking your portfolio and ensures you’re correctly recording gains &amp; losses for tax purposes. Undoubtedly, crypto is not going to be the only asset investors are holding. So it makes sense to integrate crypto holdings into Xero, where investors are tracking the rest of their assets, and their accountant / bookkeeper can do their thing.</p><h4><a href="http://trusu.com/">Trusu</a> — US to HK ecommerce imports</h4><p>Like what we’re seeing in Australia, with time &amp; scale, this could be an opportunity to place PO’s directly with US companies via Xero.</p><h4><a href="http://www.trysourcify.com/">Sourcify</a> — Flexport for product sourcing</h4><p>While the sourcing process is unlikely to touch Xero, Sourcify could remain in the transaction long term by developing software to make the PO, AR/AP &amp; payment process super simple and directly integrated into Xero.</p><h4><a href="https://opensea.io/">OpenSea</a> — Platform for crypto assets &amp; collectibles</h4><p>Since collecting a trading crypto kitties seems to be all the rage, this seems like a winner. Of course, if you’re making a profit while buying &amp; selling assets, you’ll want your accountant in the know. So an integration to Xero would help keep the IRS / ATO at bay.</p><h4><a href="https://www.flintapp.com/">Flint</a> — Mobile payments in Mexico</h4><p>While payments have been a huge source of integration for Xero, mobile payments haven’t been so popular. This would largely be due to the banked nature and wide accessibility of credit cards &amp; tap n’ go in AU, NZ &amp; UK. But in emerging markets I can see this being a massive boon for businesses.</p><h4><a href="http://runahr.com/">Runa HR</a> — Automated payroll for Latin America</h4><p>Xero started in accounting and moved into Payroll. It sounds like Runa HR plans to go the other way. At present Xero isn’t localised for LA countries, so there’s little opportunity immediately. I guess the race is on with Runa.</p><h4><a href="https://www.captivateiq.com/">CaptivateIQ</a> — Sales commission calculations</h4><p>Sales commissions have come up quite a few times while I’ve been at Xero. There’s no easy way to handle them in Xero, and they all seem to be quite different. Makes sense to have their own app, and raise an invoice in Xero at the end of the period to make sure everyone gets paid. Easy.</p><h4><a href="https://sobump.com/">Bump</a> — peer-to-peer streetwear marketplace</h4><p>When the power sellers enter the market, they will demand integration with the tools they use to run their business. Xero is on that list.</p><h4><a href="https://youteam.io/">YouTeam</a> — “Rent” engineers from consulting firms</h4><p>There are already a number of recruitment saas products that integrate with Xero, such a <a href="https://jobadder.com/au/marketplace/xero">JobAdder</a>. YouTeam seems to be an internal only version, used for managing contract engineers from a consulting firm. An integration to Xero would simplify their billing to both companies, getting everyones invoices paid faster. Wins all round.</p><h4><a href="https://www.substack.com/">Substack</a> — subscriptions for content businesses</h4><p>The first step of making a subscription business easy to implement, is taking payments from customers. Then comes accounting. Substack have the first part covered already, a few lines of code and the rest can be done in Xero.</p><h4><a href="https://lookaftermybills.com/">LookAfterMyBills</a> — bill management &amp; discounts</h4><p>Very similar to what <a href="https://www.expensecheck.com.au/">ExpenseCheck</a> provide for companies in Australia. If LookAfterMyBills decides to target the small business market, an integration with Xero would help them get the data they need.</p><h4><a href="https://treasuryprime.com/">Treasury Prime</a> — API’s for banks</h4><p>Modern banking? Bring it on. We’ve worked with plenty of banks, and if they could all get together and standardise their API’s, we’ll host the launch party #promise. Treasury Prime should think about the software their bank’s customers use, as bank feeds, lending, payments &amp; FX are becoming products that need to be far more accessible than through a website &amp; mobile app.</p><h4><a href="https://www.ourmenu.io/">OurMenu</a> — Online ordering for restaurants</h4><p>Order from your table, with just your phone, no wait staff, no menu, no in-house tech. Very cool, and since OurMenu is ingesting the menu of the restaurant they could easily integrate directly to Xero. Most POS systems send a daily invoice to summarise the transactions made through the POS. The same could be done for OurMenu, piece of cake.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*gMdyqUZ6C8P1EpYTraEvHQ.jpeg" /><figcaption>demo day crowd</figcaption></figure><p>Of 141 start ups in the W18 batch, 17 made the list for Xero integration. Last year 22 made the same list, but I suspect I got pickier this year. As stated, it seems the categories of startups YC is accepting has broadened significant this year, so many of them (robotic, ai, AR/VR, medical) are unlikely to find an integration with b2b saas software.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=fa1319649c2" width="1" height="1" alt=""><hr><p><a href="https://devblog.xero.com/growing-yc-startups-with-xeros-api-w18-edition-fa1319649c2">Growing YC Startups with Xero’s API: W18 Edition</a> was originally published in <a href="https://devblog.xero.com/">Xero Developer</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Xero API TLS 1.2 upgrade guide for Ruby]]></title>
            <link>https://riley-james.medium.com/xero-api-tls-1-2-upgrade-guide-for-ruby-c7d65d220082?source=rss-a2a16bfb4383------2</link>
            <guid isPermaLink="false">https://medium.com/p/c7d65d220082</guid>
            <category><![CDATA[xeroapi]]></category>
            <category><![CDATA[ruby]]></category>
            <category><![CDATA[openssl]]></category>
            <dc:creator><![CDATA[Riley James]]></dc:creator>
            <pubDate>Thu, 08 Mar 2018 00:45:37 GMT</pubDate>
            <atom:updated>2018-03-08T01:00:35.351Z</atom:updated>
            <content:encoded><![CDATA[<p>Xero is <strong>deprecating the use of TLS 1.0</strong>, and suggesting all API users upgrade their integrations to <strong>use TLS 1.2</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/720/1*mpDK_0CitawOB2YV8dmGXA.jpeg" /></figure><blockquote><strong>30th of June 2018 Xero will be deprecating the use of TLS 1.0 for any application communicating to any Xero API product</strong>. After this date, all applications communicating with Xero products must <strong>use TLS 1.1 or above</strong>. While it isn’t mandatory, <strong>we recommend applications upgrade to TLS 1.2</strong> as the Xero API already has support for this.</blockquote><p>Or get the news directly from Yas &amp; Yasmine live from <a href="https://www.youtube.com/channel/UC7DA_vntKKChsenzpL7QWPg">Xero DevTV</a></p><iframe src="https://cdn.embedly.com/widgets/media.html?src=https%3A%2F%2Fwww.youtube.com%2Fembed%2FntntAco2gHQ%3Ffeature%3Doembed&amp;url=http%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DntntAco2gHQ&amp;image=https%3A%2F%2Fi.ytimg.com%2Fvi%2FntntAco2gHQ%2Fhqdefault.jpg&amp;key=a19fcc184b9711e1b4764040d3dc5c07&amp;type=text%2Fhtml&amp;schema=youtube" width="854" height="480" frameborder="0" scrolling="no"><a href="https://medium.com/media/6830a468a422e07f08818816b5dc12dc/href">https://medium.com/media/6830a468a422e07f08818816b5dc12dc/href</a></iframe><p>More in-depth details on how/why:</p><ul><li>Xero Dev Portal <a href="https://developer.xero.com/tls1-deprecation">TLS notification</a></li><li><a href="https://medium.com/p/4551ea97df8">Xero Dev Blog TLS post</a></li></ul><h3>Using Ruby? How to check Ruby is using TLS 1.2</h3><p>Ruby version 2 by default uses TLS 1.2, so in most cases you should be fine. If you’re not using Ruby v2, now is the time to upgrade. If you can’t upgrade I’d suggest you test your integration and explicitly set TLS 1.2 to be used.</p><h3>Using Xeroizer gem?</h3><p>Two tests have been added to the test suite for the latest version of the Xeroizer gem, to automate testing/checking TLS 1.2 support.</p><p>You can find out more details about what’s included in the <a href="https://github.com/waynerobinson/xeroizer/releases/tag/v2.18.1">latest release of the Xeroizer gem here</a>.</p><h4>How to test with Xeroizer:</h4><ul><li>Update to the latest version of the gem</li><li>Run the tests rake test</li><li>Success</li></ul><h3>Using Xero Gateway gem?</h3><p>Two tests have been added, but won’t be pulled into master. If you’d like to use them, you can clone this fork, or just grab the test file: <a href="https://github.com/rjaus/xero_gateway/tree/tsl-12-upgrade">https://github.com/rjaus/xero_gateway/tree/tsl-12-upgrade</a></p><h4>How to test with Xero Gateway:</h4><ul><li>Clone repo or copy paste the test file.</li><li>Run the tests rake test</li><li>Success</li></ul><h3>Rolled you own gem?</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/300/1*nsqhO1RcxrvtOUZmI3O05g.jpeg" /></figure><p>You probably don’t need any help with writing a test then. You can always refer to how it’s been done in the above repo’s. Here is an additional resources that might help: <a href="https://www.proctor-it.com/ruby-tuesday-ssl-version-in-ruby/">https://www.proctor-it.com/ruby-tuesday-ssl-version-in-ruby/</a></p><h4>OpenSSL Upgrade:</h4><p>Ruby utilises what ever version of OpenSSL you have installed on your system. So you may want to upgrade this as well. After the <a href="http://heartbleed.com/">heartbleed</a> bug, most of you have probably already upgrade to a relatively recent version.</p><p>You can use the following command to determine which version of OpenSSL Ruby is using.</p><p>ruby -ropenssl -e &#39;puts OpenSSL::OPENSSL_LIBRARY_VERSION&#39;</p><p>If your version is below <strong>1.0.1c</strong>, consider upgrading.</p><p>Need to upgrade? Check these resources</p><ul><li>RVM &amp; OSX: <a href="https://www.mattburkedev.com/update-openssl-for-all-rvm-rubies/">https://www.mattburkedev.com/update-openssl-for-all-rvm-rubies/</a></li><li>Update with RubyInstaller (Windows): <a href="https://github.com/oneclick/rubyinstaller">https://github.com/oneclick/rubyinstaller</a></li></ul><h4>Got problems?</h4><p>Still having problems? Reach out on twitter <a href="http://twitter.com/RileyJamesAU">@RileyJamesAU</a> or <a href="http://twitter.com/XeroAPI">@XeroAPI</a> or email support: api@xero.com</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=c7d65d220082" width="1" height="1" alt="">]]></content:encoded>
        </item>
    </channel>
</rss>